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The Macro Assembly Program has been designed to provide a convenient, 
flexible programming environment. The program is capable of translating 
two levels of language into the instruction formats of the GE-425 and 
GE-435 computers. 

The macro assembly language provided is a logical and powerful extension 
to the essentially machine oriented, basic a^ssembly language, which is 
also available in the Macro Assembly Program. This extension takes the 
form of macro-instructions that can be used to perform operations upon 
data described in a field-oriented manner. 

Macro-instructions have been provided to accomplish the following func- 
ions: 

Input/output operations 

Arithmetic operations 

Data movement 

Procedure control 

The input/ output macro-instructions communicate with the basic input/output 
system and the extended input/output system. This in turn provides for 
standardization and ease of programming for all peripheral equipment avail- 
able for the GE-425/435. For complete documentation of these two software 
packages see the Basic Input/Output System and the Extended Input/Output 
System Manuals. 



SCOPE OF THIS MANUAL 

This manual is intended as a reference for the Macro Assembly Program. 
The manual consists of four sections, each of which is described briefly 
below: 

Basic Assembly Language -- The reader is first introduced to the 
basic, "one-to-one" language of the assembler. The format for 
this symbolic language is discussed. The GE-425/435 computer 
instruction repertoire is listed, followed by a description of the 
complementary instruction words which must accompany certain 
of the instructions. Pseudo-operations, which instruct and control 
the assembly process are described individually. 



-iii- 12/6/63 



Macro Assembly Language -- The second section of this manual 
describes the macro assembly language, with which one instruction 
may gtucidLc ocvcxax i^uiiiputcx wpci ciLiOns. A genci iti uiocussion 
of the source language is presented first, followed by four chap- 
ters which describe the four divisions of the macro assembly 
language. These divisions are: 

IDENTIFICATION DIVISION 

ENVIRONMENT DIVISION 

DATA DIVISION 

PROCEDURE DIVISION 

The third section of this manual describes the assembly program 
functions of the Macro Assembly Program. 

1+) The program operating instructions are contained in the fourth 
section of the manual. 

Each of the first two sections is preceded by a detailed Table of 
Contents. 

Before proceeding into the detailed use of the languages, an introduction to 
the computer configuration, coding form, and program operation is in order. 



MINIMUM SYSTEM CONFIGURATION 

The Macro Assembly Program requires the following minimum configuration: 

GE-425/435 Central Processor with an 8K memory 

Magnetic tape control unit 

Four tape handlers 

Printer 

Card reader 

Card punch. 



[+) Material so marked is not available at the present time. 
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Additional memory modules are used to advantage by the program, and 
additional magnetic tapes may be substituted for slower peripherals. 



PROGRAMMING FORM 

The programming form used for the Macro Assembly Program (see 
Figure 1) provides for the use of one of the languages, or for a mix of 
the basic and macro assembly languages. All source language is 
written onto this one form, representing the columns of the 80- column 
card into which each line entry is to be punched. Because of the dual 
headings on the form, it may be used for different divisions of the 
macro assembly language. 

An overall view of the use of each of the columns is given in Table 1, 
and a reference is listed to a further explanation of the information 
contained therein. The first group of field entries represent the top 
level of the dual headings, and includes entries used by both the 
Procedure Division and the basic assembly language, as well as the 
one- level headings shared with the Data Division. The entries which 
are listed below the duuule lines are those pertaining to the lower 
level of headings used only by the Data Division. 
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Figure 1. Macro Assembly Programming Form 



Table 1. Programming Field Entries 



Heading 


Col. No. 


Macro Division 
or Basic Coding 


Entry 


Reference 
Chapter 


Sequence No. 


1-6 


Data "^ 
Procedure ) 
Basic ^ 


Sequence numbers checked using 
GE-425/435 collating sequence 


2-7,21 
2-58 

X- J) 


Type 


7 


Data 

Procedure 

Basic 


*,C,R 

*,C 

* 


2-7,32 
2-9,58 
1-3 


Reference 
Symbol 


9-16 


Procedure 1 
Basic 1 


An eight character(or less) 
program reference symbol. 


2-9,59 
1-3,8 


Operation 


17-24 


Data 
Procedure 

Basic 


File Parameters 
A macro instruction, program 
mnemonic instruction^or operation. 
Mnemonic code. 


2-41 

2-9,60 
1-3,41,71 


Parameters 

1 


25-76 


Data 
Procedure -, 


p T^ 1^ g "Parameter options 

The parameter needed to complete 

u • r • 

Liie opei-QLLuii LUiic I. iuii . 


2-41 
2-10,60 

1-4,13 


Iden 


77-80 


Data ■> 
Procedure \ 

Basic J 

1 


Any four character identification 


2-9 

2-10,61 

1-4 


Data Name 


9-16 


^ 

Data 


Symbolic Data Name 


2-22 


Level 


18-19 


Data 


FD, 01, 02, 03, 04 


2-23 


Sync 


21 


Data 


L,R 


2-30 


Use 


23 


Data 


U,I,S 


2-35 


Picture 


25-40 


Data 


9,X,A 


2-24 


Occurs 


41-44 


Data 


1, 2, 3, 


2-38 


Value 


45-76 


Data 


Any Working Storage Value 


2-29 

! 



Note : The entries for the Identification and Environment Division are discussed 
in Chapters IV and V. 
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PROGRAM OPERATION 

Source program 80-column punched cards are prepared from the 

either from the card reader or from magnetic tape as card format 
records. 

The Macro Assembly Program is composed of three phases: 

1. Translator phase 

2. Selector phase 

3. Assembler phase 

The translator phase of the Macro Assembly Program analyzes the 
source input deck and determines if the macro-assembly language has 
been used. If the source program does not contain an Environment or 
Data Division, the assembler phase is loaded into the computer by- 
passing the phases not essential to the assembly, 

A complete explanation of the phases and their functions is developed 
in Sections One, Two, and Three. (Refer to flow diagram in Assembly 
Program Organization, Section Three. ) 
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I. INTRODUCTION 



As the word "basic" suggests a basic assembly language is the nearest to the 
machine language. The GE-425/435 basic assembly language consists of a 
series of symbolic codes called mnemonic operation codes; one code exists 
for each operation which the computer can execute. 

Designed as a subset of the more powerful and versatile Macro Assembly 
Program, the basic assembly language operates in two environments. When 
using the Macro Assembly Program the basic language may be combined 
with macro instructions as described in the Macro Assembly Language 
section of this manual. In other applications a programmer may elect to 
code entirely within the basic language. As e.xplained in the General Intro- 
duction to this manual, the Macro Assembly Program has one assembler 
which assembles both the basic assembly lang-uage source instructions and 
the translated macro assembly language instructions. 

All large programs can be thought of as a combination of logically distinct 
parts, or segments. The asse abler permits the user to divide his coding 
into segments and to assemble each segment separately. During checkout 
only those segments with errors need to be reassembled. 

Two modes of assembling are possible with this assembler: absolute or 
relocatable. In many cases, a relocatable, segmented environment is 
advantageous as it provides an opportunity for easy use of the more powerful 
tools provided within the GE-425/435 software system. Use of the reloca- 
table format simplifies the debugging stage of program development. Changes 
to parts of a production program may be made easier in a relocatable 
environment. In addition, when a program is written in a relocatable mode, 
the programmer is able to call in subroutines from the library at load time, 
and he is assured that the latest version of the subroutine is being used. 

The basic assembly language was designed to provide -- 

• a symbolic representation of the entire GE-425 '435 instruction repertoire. 

• a set of pseudo-operations for the reservati'>ii of memory areas and 
for the handling of decimal and octal constant.-,. 

• the optional capability of referencing a progr .mi that exists in a 
subroutine library. 



• compatibility with the macro assembly language. 

• a symbol analyzer at the termination of the assembly. 

• a convenient coding form identical to that used for the macro assembly 
language. 

SCOPE OF THIS SECTION OF THE MANUAL 

The purpose of this section of the Macro Assembly Program Manual is to 
explain the basic assembly language and its related asseml)ly process. 
Tlie format of the basic language and the rules gt^vs rning Its entry ii-.t<j 
the coding form are first explained. Following tlii.s. a general discL.ssion 
on the relocatable inode of programming is giveii to clarify this concept 
before the basic assembly language instructions an- pi'esented. Tlie 
GE-425/435 instruction repertoire, although listed in this section, is not 
described in detail. A complete explanation of these instructions is found 
in the GE-425 435 Reference Manual. 

In reading through the discussiou of the basic language iorniat, the reader 
will encounter several examples sh(iW!ng pseudo-operations which are not 
deliaed until Chapter VI - Pseudi.- Oporauons. lie' .'vvurc ti> Table B 
wliich lists the functions ol all ci iiics, i),)(>raiion ,, ■:;.;■, aid the reader 
until he has become familiar v/no i:'.>;s( opi ratiin- ii '.'hapter VI. 



1-1 



12/6 '63 



1-2 



12/6/63 



II. PROGRAMMING FORM FIELDS 



The GE-425/435 Programming Form is used for both the macro and the 
basic assembly language. Figire II- 1 illustrates this form. The entries 
on the form are shown merely to indicate their placement in the basic 
assembly language. An explanation of the various entries will be given in 
Chapter III of this section. In the paragraphs below the headings used by 
the basic assembly language entries are described. 



Sequence (col. 1-6) 



To insure proper sequence within the source input, the programmer may 
place sequence numbers in columns 1-6 of his programming form. 
Columns 1, 2, and 3 may be related to a coding form page number and 
columns four and five to a line number within the page. Column 6 is then 
available for insertions which may be necessary later. The sequence 
numbers assigned by the programmer are checked according to the 
GE-425/435 collating sequence. If a sequence error is detected during 
assembly, it is flagged as an error on the listing and the assembly continues. 

Type (col. 7) 

An asterisk (♦) in column 7 indicates that the entire source input contains 
comments. These comments are listed on the assembly output; they have 
no effect on the assembly process. 



:n a subroutine call. This is done by placing the desired octal value in the 
iwo must significant columns of the Operation field. 

Operati on Paramet ers (col. 25-76) 

The parameters needed to complete the function indicated by the Operation 
;-re entered left-justified in the Operations Parameters portion of the 
coding form. A parameter may be a symbolic address, an absolute address, 
; n expression, a literal, or a value, depending on the operation with which 
it ih associated. (Further discussion on each of these parameters is found 
in the chapter on Language Format.) In addition comments may be placed 
in the Operations Parameters following the first blank column. 

J deiH itic ation (col. 77-80) 

■"he Identification provides four columns for entering the identification of 
the symbolic assembly input of the program. The four characters are 
;,ssiL;ned by the user; they are not checked by the assembler, but are 
I'riiited on the assembly listing. 



R eference Symbol (col. 9-16) 

The Reference Symbol enables the programmer to assign symbols to 
instructions, constants, etc. The Reference Symbol may be written any- 
where within the eight-column field. 

Operation ( col. 17-24) 

The Operation portion of the coding form is used for the entry of the mnemonic 
codes representing the GE-425/435 machine operation or the pseudo-operation 
which controls and instructs the assembler. These codes may be written 
anywhere within the operation field. 

On occasion, the programmer may wish to specify a value for the operation 
field directly, and avoid the use of a mnemonic operation which may be 
meaningless. For example he may wish to indicate the type of a parameter 
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Figure 1, Sample Coding Form 



III. LANGUAGE FORMAT 



The basic assembly language is composed of two types of instructions: the 
GE-425/435 instruction repertoire and the pseudo- operations which control 
and instruct the assembler. These instructions are entered in the coding 
form using the entries defined in the previous chapter. This chapter will 
describe the format of the various language entries. A brief discussion of 
the GE-425/435 instruction format precedes the language format 
description. 



MACHINE INSTRUCTION FORMAT 

The GE-425/435 instruction repertoire includes two types of instructions: 
the single address instruction and the two-address instruction. A detailed 
discussion of these two types of instructions is found in the GE-425/435 
Reference Manual. For convenience to the reader a brief definition of each 
type is given below. 

Single Address Instructions 

The single address instructions consist of three parts: the Operation 
Code, the Address Field, and the Address Control Field. The three parts 
are located in the 24-bit GE-425/435 word as shown below: 



23 



18 17 16 15 14 



Operation 
Code 



Address 

Control 

Field 



Address Field 



The Operation Code determines the operation to be performed; the Address 
Field supplies the address for the operation; the Address Control Field 
indicates whether the address is to be modified by one of six fixed index 
registers changed by an address modification sequence, or used without 
modification. 

Two Address Instructions 

The format of the first word of the Two Address instruction is identical 
with that of the Single Address instrviction; however, the Address Control 
Field has a somewhat different significance. The Address Control Field 



i idii ates whether the first address should be modified before entering a 
irecurid Address Sequence, or whether the location of one of the fixed index 
legi -Iters should be used as the second address. 



£ YMBOLIC INSTRUCTIONS 

'I'he format of the symbolic instruction is similar to that of the machine 
i istruction, consisting of an Operation Code, an Address, and an Address 
( onU'ol. The symbolic instruction has no definite memory location until 
:issenil)ly time. However, a symbolic instruction does have a symbolic 
1 3cauon known as the Reference Symbol. When a programmer relates a 
Reference Symbol to a symbolic instruction, the Reference Symbol repre- 
i-ents the memory location which the assembler will assign to the instruction. 

tymhclic instructions are entered on the coding form as follows: 

• The symbolic location is written in the Reference Symbol columns. 

• The mnemonic operation code is written in the Operation columns. 

• The Address and Address Control are written in the Operation 
Parameters columns. 

The Address begins in the first column of the Operation Parameters. It 
may be absolute, symbolic, or a combination of both, (calculated) or the 
Address may be a literal. The Address may be terminated by a blank or by 
a comma; if it is terminated by a blank, the assembler assumes an 
Address Control Field of zero; if it is terminated by a comma, the 
assembler processes the remaining Operation Parameter as an Address 
Control Field. The Address Control Field may be an absolute, symbolic, 
or calculated value. 

Sym bol i c Reference E ntries 

Ey using Reference Symbols, the programmer equates his assigned symbol 
tt) the data with which it is associated. The symbol becomes synonymous 
to the memory cell in which the data is located; the data may be referenced 
by its symbol, eliminating the need for assigning and keeping track of 
memory locations. 

The following rules govern the construction and use of symbols. 

1. A Reference Symbol may be written in columns 9 through 16 of 
the coding form. It may contain from one to eight alphanumeric 
characters. 
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A symbol is built using' any of 37 characters of the GE-425/435 
character set. The allowable characters are: 



Alphabetics 
Numerals 
Special Character 



A, B, C, . . . . Z 
0, 1, 2, .... 9 
^ (tilde) 



At least one character of a symbol must be alphabetic. 

3. A Reference Symbol may be floated anywhere within the eight 
columns provided for the Reference Symbol. It should not contain 
imbedded blanks because blanks are not considered as part of a 
symbol. If blanks are present they will be deleted. The resulting 
symbol is right justified, and zeros are placed in the positions to 
the left of the significant characters. 

Let A represent a blank: then the following all represent the same 
Reference Symbol on a coding sheet: 

AZA^A_i^.^ 

aAZaaaaa 

AAAZ AAAA 
AAAAZAAA 
AAAAAZAA 
AAAAAAZ A 
AAAAAAAZ 
AAAAAAAZ 

All of these Reference Symbols would result in the same symbol: 
OOOOOOAZ 

4. A symbol is defined when it appears as the Reference Symbol of a 
symbolic instruction or pseudo-operation. 



5. A symbol nmst l)e defined only once within the program. Mure 
than one such definition results in an error indication by the 
assembler each time the symbol is used. 

6. When a program is written as a series of distinct regions *. 
different prefix characters may be appended to the symbols 
used in each section. 

7. Symbols used in the Operation Parameters field must be defined, 
or use of them results in an error indication on the assembler 
listing. 

8. Symbols used in the Operation Parameters field may not contain 
imbedded blanks. A blank column in the Operation Parameters 
columns indicates the end of significant data. Information 
following a blank column is treated as comments. 



assf;mbler phase 

To lully understand the basic assembly language, a brief description of the 
assembler process seems appropriate at this point. The assembler has 
two passes, briefly described below. If a symbolic analysis of the assembled 
program is desired, it may be performed following the regular assembly 
operation. 

Piis^s I 

Pass I reads the symbolic source input, assigns memory locations to 
machine instructions and constants, processes pseudo-operations, and 
constructs a table containing the Reference Symbols which appear in the 
source iirogram and the relativ(> address which each symbol represents. In 
addition, Pass I supplies the binary machine operation code for each 
mnemonic code used by the programmer. 

The primary functions of Pass I are the assignment and allocation of memory 
locations and the construction of ilie symbol table. In accomplishing these 
luni tiois. Pass I employs a "location counter" to control all memory assign- 
ments made by the assembler. The location counter always contains a value 
which correspoiuis to the next memory location which may be assigned by 
the assembler. 



*Subdi visions within segments are referred to as regions. 
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As Pass I processes a symbolic record, it identifies it as either a symbolic 
instruction or pseudo-operation. If it is a symbolic instruction, the assembler 
increments the location counter by one and looks for a Reference Symbol. If 
there is a symbol, it is placed in the symbol table with the value which was 
in the location counter prior to incrementation. A pseudo-operation can 
affect the location counter in several different ways. It may cause it to be 
incremented by a particular value as in the case of the BSS; or. it may have 
no effect at all on the location counter as in the case of the EQU. Pass I 
identifies the pseudo- operation; affects the location counter in the specified 
manner; and, looks for a Reference Symbol. If there is a symbol, it is 
placed in the symbol table, with the appropriate value from the location counter, 
and with any fla<^s which are necessary to identify and retrieve it in Pass II. 
In either case, the symbolic record and the data gathered by Pass I are 
written on an intermediate tape for Pass II processing. 

Thus. Pass I assigns relative memory locations to all instructions and con- 
structs a symbol table containing all Reference Symbols and the relative 
memory addresses which the symbols represent. 

Pas.s_n_ 

Pass II reads the symbolic instructions from the intermediate tape and pro- 
duces ihe binary object program and the assembly listing. Pass I has 
supplied a machine operation code for each mnemonic operation code. Pass II 
must supply an Address and an Address Control from entries in the Opera- 
tion Parameters. In performing this function, Pass II relies, for the most 
part, upon the data in the symbol table. 

Pass II searches the Operation Parameters of each instruction for symbols. 
When it finds a symbol. Pass II goes to the symbol table to obtain the value 
assigned to that symbol in Pass I. It replaces the symbol with the value 
from the symbol table and thus arrives at the address field of the instruction. 

When a symbolic instruction has been completely processed, it is printed on 
the assembly listing with its octal location, the contents of that location, and 
an indication of any errors detected during processing. The assembled 
instruction is stored in a binary program card area to be punched when the 
area is filled. 

When the final entry from the intermediate tape has been processed, listed 
and punched, Pass II and the assembly program are complete. An assembly 
listing has been printed and a binary program has been punched. 



Symbolic Analyzer 

The Symbolic Analyzer lists every symbol with its address and all 
references to each symbol. Each reference will consist of the 
operation code that references the symbol, the piige and line number 
of the reference, and the address of the reference. 



CLASSIFICATION OF SYMBOLS 

As mentioned in the brief assembly description above, the assembler 
constructs a symbol table in Pass L When a symbolic reference is 
encountered during a relocatable assembly it must be classified as 
either relocatable or absolute. 

Absolute Symbols 

An absolute symbolic reference in the Reference Symbol field of an 
instruction represents either a fixed machine location or a value. In 
either case, because the absolute symbolic reference will probably 
appear in the Operations Parameters field of subsequent instructions, 
the assembler will mark the symbolic reference as absolute. In the 
following example all symbols are treated as absolute. 

Example 
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Relocatable Symbols 

All Reference Symbols that are not classified as absolute are 
marked as relocatable. Therefore, any Reference Symbol which 
does not represent a fixed machine address or a value is reloca- 
table. (See Chapter IV, Relocatable Segments. ) 



OPERATION PARAMETER ENTRIES 

Operation Parameter entries may be of four different types: 

1. Absolute - a decimal integer 

2. Symbolic - a symbol 

3. Calculated - an expression 

4. Literal - a literal 

Normally all four entries appear in a program; they are described 
in the following paragraphs. 

Absolute Entries 

To form an Absolute Entry, the programmer determines the deci- 
mal value he wishes to employ in an instruction and places that 
value in the proper place in the Operation Parameters field (or 
column). 



Example 
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Note: 

Programming in absolute places the responsibility of memory allo- 
cation upon the programmer rather than upon the assembler. For 
this reason it is recommended that absolute programming be avoided. 



Symbolic Entries 

To form a Symbolic Entry, the programmer uses the symbols which 
he has assigned to his instructions and data. He references his 
instructions by their assigned symbols. 

Example 

Assume that the current value of the location counter is 1000. 



RtrEnENCe symbol 



CAT* N ft^^ 



A , ,. . . . . 









Parameters 



-- 1 c r u H F. 



!..__. -I. . .... 



During Pass I, the assembler as^^i^ns values to the symbols GRPAY 
(1004), DEDUCT (1005), and NtrrP.AY (1006). The symbols and their 
assigned values are stor^'O in 'he s>i!i:;i>l table. During Pass II, 
symbols in the Operations j*a.'':a;jieter.- arc 'looked up" in the symbol 
table and replaced by tiit; appr.jpriate values from the svnibol table. 
Thus, the asseniDty pfi^rani pro' id.'^H dii address for the programmer's 
symbolic address giving: 



LDS 


1004 


ADS 


1005 


STS 


1006,3 


BRU 


1007 



The asterisk (*) is a special type symboi; the assembler replaces it 
with the current value of the location counter. 
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Previously Defined Symbols 

Symbols are assigned values during Pass I processii^. Since the 
Operation Parameters arenormally processed during Pass II, it does 
not matter where within a program a symbol is defined so long as it 
is defined. However, in the case of several of the pseudo- operations 
(BSS, BSSL, LSB, LSBL, BPS, BPSL, ARP, ARPL, ACUM, ORG and 
EQU) the address must be calculated in Pass I since these instructions 
either control the Pass I location counter or cause an entry in the 
symbol table during Pass I. 

When an entry containing one or more symbols appears in the Operation 
Parameters field of one of these pseudo-operations, the assembler 
must use the symbol table to calculate the value of the entry. Obviously 
the assembler cannot calculate that value unless all symbols appearing 
in the entry exist in the symbol table. They are in the symbol table 
only if they were defined prior to the pseudo- operation which uses them. 
Therefore, the pseudo- operations BSS, BSSL, LSB, LSBL, BPS, BPSL, 
ARP, ARPL, ACUM, ORG and EQU demand that symbols used in 
Operation Parameters be previously defined. Consider the following 
example: 



C alc ulated Entries 

Tt < form a calculated entry the programmer states the entry as an 
expression, thus allowing the assembler to calculate the value of 
the entry. 

An expression is a series of symbols and/or integers called elements 
which are connected by the operators: +, -, *, and / These operators 
represent the arithmetic operations: add, subtract, multiply, and 
divide, respectively. According to the normal arithmetic rule, the 
elements of an expression are evaluated from left to right, with 
maltiplication and division preceding addition and subtraction. 



El>;ample 



Calculated Addressing 



A:.sume that the current value of the location counter is 1000. Note 
th;it the * in this case is an operator. The * as an element repre- 
serits the current value of the location counter. 



REFERENCE SYMBOL 



DATA NAME 



X,A,43xl.,£.l, 






I — 



A^ 



LlCu 



>PeRATIDN PARAMETERS 



= I C T U R F 



— i i I I i-- - 



In Pass I, the assembler will attempt to reserve the space for TABLE 1 
by adding the symbolic value A to the location counter. The assembler 
goes to the symbol table to find the value of A. However, A has not 
yet been defined and is not in the symbol table. Therefore, the location 
counter cannot be incremented and space cannot be reserved. The same 
procedure takes place for TABLE2; A is now in the symbol table and 
ten memory locations are reserved. 



A'-i. T f_^ y 



T 
E 


REFER fNCF SYMBOL. 


OPERATION 
1 


OPERATIDN PORAMFTER 


DATA NAME 
^ 16 


. EVElJ 


:fO 


s 

c 


ZT 


'^ 


ZA 


"= f C T U R F 
26 


— 


■ ' J --.1 _. . 1 _X. _J_ . .jL 




-r- 


^-- 


— 




^.-^-^-.^_..£. 

R 


1^4- 


-KA^ 


1 




y,-r,a., Q i , , J J . 


p.u ; 




J 




2., , , . . 


^fi 




! 


B 




6- 
B 


s,.s 


1 




a, , , , ' /\ ' '^ 


-- ... ._,. 


lx_S..._ 


1 






L^.CLU 




1 


a .;.... 




\ 


^~:i:::"1 


















1 





A.yJ ^ ]Z\^ 



Pass I assigns values to the symbols B (2), GRPAY (1004), DEDUCT 
(1006), NETPAY (1008) and T (3). The symbols and their assigned 
values are stored in the symbol table. 
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During Pass II, the symbols in the Operation Parameters are 
replaced by the appropriate values from the symbol table. Having 
evaluated the expression in the Operation Parameters, the assembler 
calculates an address giving 



LDS 


1005, 


5 


ADS 


1007, 


1 


STS 


1009 




BRU 


1023 





The following examples demonstrate the various types of entries 
allowed in the Operation Parameters field. 



Examples 

1. Absolute Address, Fixed Index 



REFERENCF. SYMBOL 



DATA NAMF 



OPERATION 



LO) S 



T " "!"" 



OPERATION PARAMETERS 



^ t C T U R E 



1l^6^ 



Develop an effective address by adding the address portion of 
index register six to the address portion of the instruction. 
Load the contents of this location into the single accumulator. 

2. Symbolic Address, No Index 



LjiS. 






J,A, 3 ^-L.£ . 



Load the contents of symbolic location TABLE into the single 
accumulator. 
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3. Calculated Address, Fixed Index 



REFERENCE SYMBOL 


OPERATION 
1 


OP K RATION PARAMETERS 


DATA NAME 
9 16 


17 


LEVEL 
IB 19~ 


20 


S 


22 


E 


24 


PICTURE 
2B 




L 


X>,S 












T,A,Ti.L,£, + ,1 ,, ,3, , , , . , 




































■ 1 1 1 1 1 1 . 1 






















Develop an effective address by adding the address portion of 
index register three to the calculated address TABLE+1. Load 
the contents of this location into the single accumulator. 



4. Calculated Address, Symbolic Index 







I 1 






1 


! 






L-D,S{ 




T,A,B.L,£. + ,1 .J ,-B,T 










. 




"T . ~r 


1 1 , . 1 . , , , 1 . 1 ] 



Same as Example 3, if BT EQU 3. 



5. Calculated Index 






T^jB., t , , i ..^^l^^.±Jl. 



Same as Example 4, if G EQU 1, D EQU 2. 
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6. Next Word Indexing 



refere:nc:e symbol 


OPERA 


rroN 

I 


OPERATION PARAMETERS 


DATA NAME 


17 


1 (■. V t. L 

m 13 


.c 


5 


22 


B 


z* 


pic: T U R E 
2S 












T^AJ,t.,£,, ,1, , , , 


1 1 J 1 








1.0. o 


. . . . 




__4- -1.. f. - 




--- 


- 
















"I" 











The instruction calls for next word indexing. The AMS word 
is an index. An effective address is developed by adding the 
address portion of the Address Modification Sequence (AMS) 
word to the symbolic address TABLE. The contents of the 
effective address are loaded into the single accumulator. 



7. Multiple Next Word Indexing 



REFEIRENCE SVMBDL. 


OPERA 


TICIN 


OPERATION 


P AR AME T 


ERS 


DATA NAME 
9 


, 


\y 


',rfi 


20 


C 






24 


PICT 


J R e: 








M.,F ,/wTr 


T'^ 


— 




T,A ,39,L,£,, ,f. , , , , 








D, ,,1. , 




,,.l 1. .,_l.... -L 1. _J . J 


x _^ 


-- 




2,5 






"K.Ai-r.P.i , . , . , I 







'r1 













If E EQU 7, the instruction calls for next word indexing. The 
AMS word is an index-, its symbolic address is added to the 
symbolic address TABLE. The AMS word specifies continuation. 
The next AMS word is examined. It is an index. Its address is 
added to the previously calculated address. Since no further 
continuation is specified, the effective address has been developed. 
One word is moved from that location to the symbolic location 
RATE. 
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Cr nlent Restrictions 

Tl following restrictions exist on the content of Operation Parameters: 

1. External global symbols (as described in Local and Global 
Symbols, page 1 - 31) are permitted only in the expression 
that indicates the address portion of Operation Parameters; 
they are not permitted in the Address Control. 

2. The value that results from calculating the expression for 
address control must be absolute. (See Relocation Errors, 
page 1 - 35.) 

Si .• 1-^ Restrictions 

Tt,( Address Control Field of the GE-425/435 instruction word may contain 
values which range from to 7. (See word format on page 1 - 6 .) It 
m:.iy indicate a fixed index register -- values 1 to 6. It may indicate an 
Ac dress Modification Sequence -- value 7. It may indicate that no address 
control is required -- value (this is normally indicated by terminating 
the Address with a blank, although "0" will produce the same result). 

Tl e Address Field of a GE-425/435 instruction word may contain values 
which range from to 32, 767. The full capacity of the Address Field is 
not required by all GE-425/435 instructions; for example, the value in a 
Sliilt instruction can range only between and 31, while Lhe restore value 
in a Branch Counter can range only between and 511. 

A;- the assembler constructs the fields for a machine instruction, it com- 
pares the binary representation of the value which the programmer has 
specified for a field, with that field's allov/able range. When the value 
exceeds the allowable range, a predictable result always occurs. The 
assembly retains from the specified value in its binary representation, 
a number of the least significant bits sufficient to fill the field without 
overflowing. 

Values which exceed the allowable ranges are truncated as follows: 

1. All Address Control Values are truncated modulo-8 

2. All Addresses are truncated modulo 32, 768 

3. All Shift Counts are truncated modulo -32 

4. All counts specified for Branch Counters, Move Counters, 
LPW's or DCW's are truncated modulo-512. 
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Literals 

During the course of coding a program, there are many occasions when a 
programmer desires to use constants. To enter those constants, the 
programmer uses one of the many pseudo-operations that are provided 
in the basic assembly language or he enters them in the Operation 
Parameters as literals. A literal specifies the actual value of the data 
that is to be operated on by the Operation. The allowable length of the 
literal is determined by the type of literal and the Operation with which 
it is associated. Any literal which exceeds the number of allowable 
characters or includes an invalid character will be flagged as a literal 
error on the assembly listing. 

The four types of literals that are allowed in the basic assembly 
language are alphanumeric, decimal, octal, and binary. 

1. Alphanumeric Literals 

Alphanumeric constants are entered in a program by means of 
the AN pseudo-operation, or by entering them as alphanumeric 
literals in the Operation Parameters. An alphanumeric literal 
is indicated in the Operation Parameters by preceding the 
literal with a quotation mark ("), entering the literal, which 
can be a maximum of 16 characters in length, and terminating 
the literal with a quotation mark ("). 

Since the quotation mark is used as a delimiter, it is the only 
character of the computer's character set which may not be 
part of an alphanumeric literal. 

The Operation normally specifies the number of words of 
constant information that the assembler will generate for the 
literal (see page 1 - 30 ). The assembler right justifies the 
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literal within the field that represents these generated words. Zeros 
are inserted in the left most character positions when the literal 
does not completely fill the field. 

Example 





REFERENCE SYMBOL 


OPEHATION 

^. . 1 


OPERATION PARAMETERS 




DATA N AMF 




-■i-"^^ 


.0 


s 


„ 


"^s 


24 


P 1 C T U R F 
28 






, 


- 












A-1 '.-1 


1 




. 






1 1 ■ 1 , ■ 1 1 1 














L__L_ _l _.J 




i 


- 


















L:D ,9 : . 

r;rlu.-„_ 

r " ' ' ' ' 

.b;5 ^r. 




■■ ,P ,A,V .R.if, L. L. ,R 


£ 


C 


d 


P 


D 








1 




W .f , A,D,R, ■f-..?, , . 














P>, , 




' 




" .P,A,G,t, M .i.' . ' 






















H.J ,A,D,R,-f ,T , , , 














H.f^fl.DiR, , , 




— 
















" ^ 1 
















i ' 




























t. ._,_..._ ^ . . _^_._ 

















After executing the instruction at location A, the quadruple accumu- 
lator would appear as follows: 



P A 


Y R L 


L RE 


C R D 



After executing the instruction at location B, the double accumulator 
would appear as follows: 



PAGE 


A N p . 
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Decimal Literals 

Decimal constants are entered in a program by means of the 
decimal data pseudo-operations or by entering decimal literals 
in the Operation Parameters. A decimal literal is indicated in 
the Operation Parameters by preceding the literal with the 
pounds sign {#) and entering the iiteral, which can be 16 digits 
in length, and terminating the literal with a pounds sign or a 
blank. When a literal is used in a two address instruction which 
refers to a fixed index register, the comma or pound sign may 
terminate the literal. 

A decimal literal must contain only the digits 0-9 and may be 
preceded by a plus {+) or minus (-) sign. If these rules are 
violated, a flag will appear on the assembly listing. 

The Operation normally specifies the number of words of 
constant information that the assembler will generate for the 
literal. (See list of literals on page 1 - 30. ) The assembler 
right justifies the literal within the field that represents these 
generated words. If the literal does not completely occupy the 
field, zeros are inserted in the left most character positions. 



Example 



HEF'XFiENCE SVMBO. 


OPERATION 

1 


OPERATION PARAMETER* 


D A T i, f^ A M ■- 


T 

1 L F V E 1. 

1 7 ■ 1 ^ t 9^ 


.:, 


s 


7.2 


E 


24 


PICTURE 

2B 


_.... [ L . .J .. J .. L .... .1 ... 

A.!.. " , \1' ' . 




























■■ . : """"""" 




— 














■f.. Ij.*.j. . J. ^ L. a. -1 1— 








r 




C,^j,U^«lTt. ._.._.,. i.-.J L 


A,D:D. 










L.^i'J.UJ-^--i -. . L i_ 








#..,ji^i_.a.jj,.^iL..Oxii^ _-...-. 






\p h.j »..._.._..._., , 




[ , . -*■ -■ J. . -i J-- -....-. .1 1 1 


---"--'- 


: ' . ■ i L L ■ 
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After executing the instruction at location A, the single accumu- 
lator would appear as follows: 



1 



After executing the instruction at location B, 
lator would appear as follows: 



the double accumu- 



00480000 



Since the literal is negative, the least significant character of 
the accumulator must indicate it. 

3. Octal Literals 



Octal constants are entered in a program by means of the octal 
pseudo- operations or by entering octal literals in the Operation 
Parameters. An octal literal is indicated in the Operation 
Parameters by preceding the literal with two characters: pound 
sign # and the letter O. The octJil literal is entered immediately 
following these two indicators; it may be a mjiximum of 32 
octal numbers and is terminated by either the pound sign (#) or 
a blank. 

An octal literal must contain only the octal numbers 0-7 and 
must not be preceded by the plus or the minus sign. If these 
rules are violated, a flag will appear on the assembly listing. 

The Operation normally specifies the number of words of constant 
information that the assembler will generate for the literal, ( See 
list of literals on page 1 - 30. ) The assembler right justifies the 
literal within the field that represents these generated words. 
If the literal does not completely fill the field, zeros are inserted 
in the left most character positions. 
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Example 




OPEHATtON PARAMETER* 



^ t C T U R E 






4,5,6, 



.t. 5,fe..#. 



The decimal number to be converted to a binary value must be 
composed of the digits 0-9 and must not be preceded by a 
plus (+) or a minus (-) sign. If these rules are violated^a flag 
will appear on the assembly listing. 

The assembler constructs the final binary value for the literal 
by converting the indicated decimal value to binary and right 
justifying the result in one machine word. The assembler inserts 
zeros in the unused left most bits of the word. 



Example 



After executing the instruction at location A, the double accumu- 
lator would appear in octal as follows: 



565656565612565 el 





REFERENCE S v M B O L. 


OPEH*T,ON 1 OPERATION PARAMETER* 




nATft NAMF 
9 16 


" 


L t- V £ L 




s 


7.2 




24 


Pic r U R E 






- -! - 1-4 -- 








.__a- .1 .-.-1 ...I- ..J- 1 1- -1 1 --L- -J -L--i 














A 


1 




«,B,3.i,«^ 




, , S T ,5 




1 






l^M^L,f^.JL. ^x-^^ 




3 


A,e m 








1L.&^X. ^ a---. . .- • 








^p 






T.W,«f,] .W,C, , 























The instruction at location B would cause the octal mask 00007777 
to modify location FIELDB. 

4. Binary Literals 



After executing the instruction at location A, the single accumu- 
lator contains the binary value 32. After executing the instruction 
at location B, location TWOINC has been increased by the binary 
value 2. 



Binary constants are entered in a program as binary literals. 
These are indicated in the Operation Parameters by preceding the 
literal with two characters: a pound sign {#) and the letter B. A 
decimal integer from to 16, 777,215 immediately follows these 
indicators and constitutes the value of the binary literal. The 
literal is terminated by either the pound sign (#) or a blank. When 
a literal is used in a two address instruction which refers to a 
fixed index register, the comma or pound sign may terminate the 
literal. 



Immediate Value Literals 

For each of the four types of literals just explained, the assembler 
generates at least one full machine word of constant information. 
These generated words are placed starting at the end of the main 
body of coding. 
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In addition, the complete literal capability can be utilized by 
the following immediate value instructions: 

AIM 
AIX 
CMI 
CXI 
MFI 
LXI 


X 



When literals appear in the Operand Parameters of immediate 
value instructions, remote constant information is not generated 
by the assembler. Because of the nature of immediate value 
instructions , the value of the literal is placed in the address 
portion of the instruction itself. 

The following restrictions apply to use of immediate value 
instructions: 

1. Alphanumeric literals must not exceed two characters in 
length. 

2. Decimal literals must be integers within the range ± 799. 

3. Octal literals must not exceed 5 octal numbers in length. 

4. Binary literals must be indicated by decimal integers 
which do not exceed 32, 767. 

If any of these restrictions are violated, a flag will appear on the 
assembly listing. 



Example 





Rfc-i-EHFNCE SYMBOL 


:i n t R A 


TION 1 


OPERATION PARAMETERS 




DATA NAME 


1 


20 


S 

c 


22 


S 

E 


24 


P IC T U H F 
28 




. -. ^^..-x-^-.- 


■ , 












. , . 1 ■ 1 1 1 < 1 • 1 




1 ^ 


















' ' ' 










1 1 1 i 




A._^._,.^^_^-^.-- - 


c'>C,X' 










VM, " , ,3 
















J 




R 












«,.:i^.l ,4, ,,Mi . . . . 


-■ ^-^ \"'- 


B K.C- 












*c' : TTT . 


AIjX 
Pi 1 K 












■tf,0', i,0,-tt,,,S. . 


^.::::1':' ' 












1^'.^S_^Q^^h.^_. 
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The instruction at location A causes the letter M to be compared to 
index register 3. The instruction at location B causes the decimal 
value -14 to be logically compared to index register 4. The instruc- 
tion at location C causes index register 5 to be increased by the 
octal number 10 (decimal 8). The instruction at location D causes 
the index register 6 to be increased by 50. 

Literal Pooling - Assembler Action 

As previously mentioned, when the assembler generates words of 
constant information the words are placed starting at the end of the 
program. The location of the last instruction in the program is known 
at the end of Pass I. The assembler begins building the required literals 
i: the succeeding memory cell. 

V/hile building the required constants, the assembler insures that no 
duplicate constants occur when constants are identical in word length. 
When constants are unequal in word length, an attempt Ls made to match 
tiie smaller length constants with portions of the longer constants to 
avoid duplication. 

I''or example, assume that the final location used by the program is 2020. 
When the instruction 



LDQ 



#1# 



is encountered, an addition is made to the literal table in the following 

v.ay: 



LOCATION 


CONTENTS 


2021 


0000 


2022 


0000 


2023 


0000 


2024 


0001 



And the address lor the instruction at location A becomes 2024. 
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When the programmer uses the following constructions, no additions are 
made to the literal table: 



CONSTRUCTION 



etc. 



Instructions Which Permit Literals 



CONVERSION 



LDS 


#0# 


LDS 


2021 


LDD 


#0# 


LDD 


2022 


LDT 


#0# 


LDT 


2023 


LDS 


#1# 


LDS 


2024 


LDD 


*1# 


LDD 


2024 


LDT 


#1# 


LDT 


2024 


LDS 


#0# 


LDS 


2024 



LDS 


#B1# 


LDS 


2024 


LDS 


"1" 


LDS 


2024 


LDD 


"1" 


LDD 


2024 



Literals are permitted with the mnemonic operations in the table below. 
The number of words generated can be influenced by the length of the 
literal. If the literal specified is larger than the number of words speci- 
fied by the mnemonic operation, a flag will appear on the assembly listing 
and the larger literal will be generated (up to a maximum of four words). 
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Instruction 

LOAD SINGLE ACCUMULATOR 
LOAD DOUBLE ACCUMULATOR 
LOAD TRIPLE ACCUMULATOR 
LOAD QUADRUPLE ACCUMULATOR 
ADD DECIMAL SINGLE 
ADD DECIMAL DOUBLE 
ADD DECIMAL TRIPLE 
ADD DECIMAL QUADRUPLE 
SUBTRACT DECIMAL SINGLE 
SUBTRACT DECIMAL DOUBLE 
SUBTRACT DECIMAL TRIPLE 
SUBTRACT DECIMAL QUADRUPLE 
COMPARE ALPHA ACCUMULATOR 
COMPARE DECIMAL ACCUMULATOR 
VARIABLE LENGTH MULTIPLY 
VARIABLE LENGTH DIVIDE 
EXPLODE 

ADD BINARY TO MEMORY 
ADD BINARY TO INDEX 
SUBTRACT BINARY FROM MEMORY 
SUBTRACT BINARY FROM INDEX 
AND TO MEMORY 





Number of Words 


Mnemonic 




Generated 




bi 


the Lltera!. 


LDS 




1 


LDD 




2 


LDT 




3 


LDQ 




4 


ADS 




1 


ADD 




2 


ADT 




3 


ADQ 




4 


SDS 




1 


SDD 




2 


SDT 




3 


SDQ 




4 


CAA 




1-4* 


CDA 




1-4* 


VLM 




2 


VLD 




Z 


EXP 






ABM 






ABX 






SBM 






SBX 






ANM 







* CAA and CDA allow 1-4 words. The number of words required depend 
on the length of the literal. 
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NuiTibet 


of Words 


Instruction 


Mnemonic 




Generated 






hx. 


the 


Literal 


AND TO INDEX 


ANX 






1 


OR INCLUSIVE TO MEMORY 


RIM 








OR INCLUSIVE TO INDEX 


RDC 








OR EXCLUSIVE TO MEMORY 


SXM 








OR EXCLUSIVE TO INDEX 


RXX 








COMPARE MEMORY TO MEMORY 


CMM 








COMPARE INDEX TO MEMORY 


CXM 








MOVE FROM MEMORY 


MFM 








LOAD INDEX 


LDX 
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IV. RELOCATABLE SEGMENTS 



li; every program, there are strings of coding which can be isolated as 
logical entities. For example, in a payroll application, one might choose 
tc) identify such entities as initialization, tax calculation, dollar extension, 
bond deduction, etc. Each of these logical entities is called a segment. 
A relocatable segment is a logical entity which can be placed anywhere 
in memory at load time. The assembler assigns relative locations to 
the instructions and constants, and supplies extra information in the 
object program to permit the loader to position the program in any con- 
venient memory area and adjust it to operate properly wherever it is 
placed. 

The user may organize a large program into many small independent 
segments. Each of these segments may be assembled independently of 
the main program. Since each segment is tested separately, the cause 
of a bad result may be rapidly isolated. K the same bad result occurred 
while testing the complete object program, it could be attributed to an 
error in any of its parts, and could result in unnecessary computer time 
and programmer effort to isolate the bug. The use of segments reduces 
the total elapsed time in program development, since the segments can 
be distributed among several programmers who work simultaneously. 

Changes to a relocatable segment are made by correcting the symbolic 
ccjding and reassembling only the segment found to be in error. If the 
corrections change the size or the storage allocation of this relocatable 
segment, storage assignments in the main program, with which the seg- 
ment is used, are not affected. Conversely, independent changes in the 
s :ze and storage assignments of a relocatable main program do not affect 
tiie use of the relocatable segments called upon by the main program. In 
addition, if certain segments are required in other programs, the relo- 
catable binary output can easily be incorporated without a time consuming 
reassembly. 



LOCAL AND GLOBAL SYMBOLS 

When a program is written for a relocatable assembly, a means of 
communication between the series of distinct but interacting relocatable 
segments is required. The global symbol forms the basis for this 
communication. A global symbol may be defined as a symbol which is 
referenced in more than one segment of a relocatable program. A local 
symbol is one which is referenced only within the segment in which the 
symbol is defined. 
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There are two types of global symbols: internal and external. An in- 
ternal global symbol is "internal" to the segment in which it is defined. 
An external global symbol is "external" to any segment in which it is 
referenced except that segment in which it is defined. See the examples 
and explanation following. 

After a relocatable segment has been coded, the user must indicate to 
the assembler, by use of a pseudo-operation, those symbolic references 
which the segment requires for communicating with other segments at 
execution time. He must further indicate whether the global symbols 
are internal or external by his choice of pseudo-operation. 

A detailed description of the pseudo-operations which provide the 
necessary indication to the assembler fon global symbols is presented 
in Chapter VI, Pseudo-Operations. At this point, only the general con- 
cept of the interrelationship of segments is given. 

Consider the example on the opposite page in which lines of coding 
appear in three separate segments. 

In segment 1, there are three symbolic references: FICA, PRINT, and 
A. A and PRINT are referenced only within segment 1 and, hence, are 
not required for communication purposes. These symbolic references 
are local symbols. Segment 1 requires communication with segment 2; 
the symbol reference FICA is common to both segments. To insure 
proper linkage at load time, the user must indicate that FICA is global 
when segment 1 is assembled, and again that FICA is global when seg- 
ment 2 is assembled. In segment 1, FICA is termed an external global 
reference because it is defined outside the segment. In segment 2, 
FICA is termed an internal gl obal reference because it is defined within 
the segment. Appropriate pseudo-operations for indicating internal and 
external global symbols are found on pages 1-74 and 1-76. 
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REFERENCE S 


VMBO L 






OPERATIC 

I 


N 










OPERATION 


P A 


R A 


METERS 




4 




DATA NAME 

a 16 


17 


"^rft 


20 


S 
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22 
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24 
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The following table lists the symbolic references listed in this example 
and comments as to their relationship in the segments. 



Symbolic Reference 
FICA 



PiaNT 

A 

CALTAX 

CALTAXIT 



Comm ent 

External global reference in 
segment 1 

Internal global reference in 
segment 2 

l-iocal to segment 1 

Local to segment 1 

External global reference in 
segment 2 

Internal global reference in 
segment 3 

Local to segment 3 



ASSEMBLER ACTION IN GLOBAL SYMBOUC REFERENCES 

If a symbolic reference in a segment is an internal global reference, a 
special flag appears in the symbol table. When the symbol table has 
been completed, the assembler scans the table and punches out internal 
global cards containing the names of the symbols and their assigned 
addresses within the segment. The loader uses this information when 
the segment is loaded into memory. 

If the symbolic reference is an external global reference, the assembler 
performs the following actions: 



1. 



Each instruction in which an external global symbol appears is 
flagged. The address of the instruction is calculated by 
assuming that the external global symbol itself has an absolute 
value of zero. 

The assembler punches out external global cards containing 
the external global symbol names and the relative address(es) 
assigned to each. 
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RELOCATION ERRORS 

When coding for a relocatable assembly, it is sometim(;s possible to 
inadvertently generate errors in the use of relocatable reference symbols 
in the Operation Parameters. When these errors are flagged by the 
assembler, it is important that the programmer understand the reason 
why. 

Reference Symbols, when they are encountered by the assembler, are 
classified as being relocatable or absolute. Operation Parameters are 
most often constructed from Reference Symbols. The way that Reference 
Symbols are used in the construction of CJperation Parameters 
determines whether the address in the Ojjeration Parameter field is 
relocatable or absolute. When the assembler has made this determina- 
tion, it can indicate the result to the loader by means of the reserved 
bits on the binarjr output. 

All relocatable programs are assembled with their addresses starting 
at zero. When they are loaded into the machine at object time, their 
location in memory depends upon the current setting of the program 
counter. Since they will be relocated, the loader must be aware that 
tlie relocatable address will be modified (added to the base load 
address) and that absolute addresses must remain unaltered. For 
example, consider the following instructions assembled relative to 
zero. 



REFERENCE SYMBOL 


OPERATION 

1 


P £ l-c ,\ T- r V N 'i A k A M :_ T r: r -. 


DATA name: 
9 16 


,7 


LEVEU 
IB 19 


zo 


s 

c 


■^^ 


E 


24 


PICTURE 


A 


1 


Lb,s 












B^ 





, 


sfk.s 


A 










c, , 


, 






1 1. 1 1 
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sSX 












V. , 
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B:??,U; 










e, , 








£.^ ^_^^... 


, 


BiS.si 










7 , , 








P.. - .-..._^_.,. 
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B 




i ^ 




1 . J 
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L 






-- 


o 
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c. ._...._.. . 


— L 


'£icf.ij.:__ 


l—l 


z-_^. . 


1 






...^. -.,..__..... 1 






! '' 










. ^^4 




' ' 










, , 1 
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The binary output appears as follows: 



Relative 
Location 



REFKRENCE 5YMBO 



DATA M A M F 



S;1\ST.„. 

(^rfesijryted 
ir*a§rvied 



"1 




OPERATION P AR AM« T E R 


.„ 


P *C ' U R E 


i 


(,H,VR 


■ 


si 
si 


c,a,),A 




C,5,),R 




f, b, ) ,R 


ttor 




tfor 




< 


L5LJ..A . ^ ._^^ ^ 



where R is a flag to the loader which indicates that the address must 
be relocated and A is a flag which indicates the address must remain 
unchanged. Therefore, if the program is loaded starting at 1501, it 
would appear in memory as follows: 



Memory 
Location — 

1501 
1502 
1503 
150A 
1505 
1506 
1507 



I..D.5 ..__ 

S.T S . _ 

(reserved 
(reserved 



; , 4 J 


1 ) 1 1 ' 1 . 































1 5 S, , , , 




















I 5 n b. . , , 








location) 
location) 


1 .S 7 . . . . 
























i 








l_ .,,_ .. __ 


1 1 1 1 t 1 


1 , 




,_ 
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If the program were loaded at location 1630, it would appear as 
follows: 



Memory 
Location 

1630 
1631 
1632 
1633 
1634 
1635 
1636 



REFERENCE SYMBOL 


OPERATION 
! 


OPERAnOM PARAMETERS 


DATA NAME 
9 16 


17 


LEVEL, 

in 19 


20 


s, 

"<: 


„ 




24 


PICTURE 
2B 




L,0,S 
















i^ 


R.S 


-P\ 


































J ,k,3 , t, 




(reserved 


locatiottL 






L 


es^rvpd 


l0( 


3at 


Ion 


) 






n,D 








z 


_. .1 i L__1.^J J L. 


















.- i— 1 






. ..J. 1.-^1 A. _! L 1 a -L 1_ ! 



When the assembler encoimters a relocation error (some value which 
is meaningless), a flag is produced on the assembly listing. It i£ 
imperative that the programmer understands the assembly process of 
detectii^ errors so that these mistakes can be avoided or corrected. 

By far, the vast majority of programs that are written contain addresses 
formed by connecting symbols and values with plus and minus signs 
only. In this environment, the programmer should check to discover 
whether the value of the address is absolute, relocatable, or a relaca- 
tion error. The assembler also checks these values during assembly. 

Procedure for expressions connected by plus and minus only 

1. Examine each element of the expression. If it is a num<;ric 
value, remove it from consideration. If it is a symbol 
which represents an absolute value, remove it from con- 
sideration. If it is a symbol which represents a relocatable 
value, substitute the letter M (this value can be Moved at 
load time) in place of the symbol. 
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2. This will leave an expression in terms of one unknown, M. 

3. Combine like terms in this expression 

a. if the result is or nothing, the address is 
absolute and cannot be moved. 

b. if the result is M, the address is relocatable 
and must be moved. 



c. 

Examples 
1. 



if the result is anything else, the address is 
a relocatable error. 



Absolute 



SRSA 



The expression for the address of the Shift instruction contains only one 
term, i. e. , the absolute value 3. Because it is an absolute value, it is 
ignored. Since the result has produced nothing, the address is considered 
absolute. 



2. 



Absolute 



EQU 



SRSA 



ALTER 



Since the symbol ALTER represents an absolute value, it is ignored. 
The remaining procedure is the same as Example 1. 
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Relocatable 



EEN0 



BSS 



LDS 



EENO 



The symbol EENO represents a relocatable memory cell which will 
be moved at load time. The letter M is substituted for the symbol 
EENO. Since the result is M, the address is relocatable. 



4. 



Relocatable 



GR0S 



BSS 



LDS 



GROS+7 



M is substituted for the symbol GROS and the 7 is ignored, 
result is M, the address is relocatable. 



Since the 



5. 



Absolute 



BEGTAB 
ENDTAB 



BSS 
BSS 



99 
1 



BCTR 



ENDTAB - BEGTAB 



The symbols ENDTAB and BEGTAB both represent relocatable elements. 
When M is substituted, the equation M - M = results. Since the 
equation has produced 0, the address is absolute. This example illus- 
trates the fact that the difference between two relocatable symbolic 
references is absolute. 
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Relocatable Error 



BEGTAB 
ENDTAB 



BSS 
BSS 



99 
1 



BCTR ENDTAB + BEGTAB 

The symbols ENDTAB and BEGTAB both represent relocatable elements. 
When M is substituted, the equation M + M = 2M results. Since the 
result is not or M, the address is flagged as a relocation error. 

These examples cover some of the more common types of expressions 
that can appear in the Operation Parameters. On occasion, a pro- 
grammer will wish to combine symbolic references by connecting them 
with the multiplication (*) and division (/) operators. In this environ- 
ment, the rules for determining the nature of the Operation Parameters 
become slightly more complex. A description of this procedure may be 
found at the end of this section of the manual in the Supplement to 
Chapter IV, on page 1-151. 



V. COMPUTER OPERATION CODES 

The GE-425/435 instruction repertoire is listed on the following pages. 
A detailed description of the functions and operation of these instructions 
is found in the GE-425/435 Reference manual. In the listing which follows, 
all two-address instructions are indicated by (2 A) in the left margin. 



LISTING OF COMPUTER OPERATION CODES 

Data Transfer Instructions 

Load Single 

Load Double 

Load Triple 

Load Quadruple 
(2A) Move From First Memory 
(2A) Load Index 
(2A) Move From Immediate 
(2A) Load Index with Immediate 
(2A) Store Single 

Store Double 

Store Triple 

Store Quadruple 
(2A) Move To First Address Field 
(2A) Store Index in Address Field 

Move 
(2 A) Move on Index Control 

Move Counter 



Mnemonic 


Octal 


LDS 


40 


LDD 


41 


LDT 


42 


LDQ 


43 


MFM 


30 


LDX 


30 


MFI 


31 


LXI 


31 


STS 


44 


STD 


45 


STT 


46 


STQ 


47 


MTA 


32 


SXA 


32 


MOV 


06 


MXC 


06 


MCTR 
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Arithmetic Instructions 
Add Decimal Single 
Subtract Decimal Single 
Add Decimal Double 
Subtract Decimal Double 
Add Decimal Triple 
Subtract Decimal Triple 
Add Decimal Quadruple 
Subtract Decimal Quadruple 
(2A) Add Immediate to Memory 

{2A) Add Immediate to Index 
Variable Length Multiply 
Variable Length Divide 
Add to Memory Single 
Add to Memory Double 
Add to Memory Triple 
Add to Memory Quadruple 
(2A) Add Binary to Memory 

(2 A) Add Binary to Index 

(2A) Subtract Binary from Memory 

(2A) Subtract Binary from Index 



Mnemonic 


Octal 


ADS 


50 


SDS 


60 


ADD 


51 


SDD 


61 


ADT 


52 


SDT 


62 


ADQ 


53 


SDQ 


63 


AIM 


33 


AIX 


33 


VLM 


27 


VLD 


26 


AMS 


54 


AMD 


55 


AMT 


56 


AMQ 


57 


ABM 


34 


ABX 


34 


SBM 


35 


SBX 


35 



Shift Instructions 

( See Tables 1 and 2 on page 1-54 ) 

Shift Right Single Decimal 

Shift Right Single Decimal and Set 

Shift Right Single Alpha 

Shift Right Single Alpha and Set 

Shift Right Double Decimal 

Shift Right Double Decimal and Set 

Shift Right Double Alpha 

Shift Right Double Alpha and Set 



Mnemonic 


Octal 


SRSD 


22 


SRSDS 


22 


SRSA 


22 


SRSAS 


22 


SRDD 


22 


SRDDS 


22 


SRDA 


22 


SRDAS 


22 



In all shift instructions, bits 14 through 7 determine the length 
of the accumulator, the direction, and the type of the shift. 
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Shift Instructions (Continued) 

Shift Right Triple Decimal 

Sluft Right Triple Decimal and Set 

Shift Rigiit Triple Alpha 

Shift Right Triple Alpha and Set 

Sliift Right Quadruple Decimal 

Shift Rigiit Quadruple Decimal and Set 

Shift Rigiit Quadruple Alpha 

Shift Right Quadruple Alpha and Set 

Shift Left Single Decimal 

Sliift Left Single Decimal and Set 

Shift Left Single Alpha 

Shift Left Single Alpha and Set 

Siiift Left Do-ible Decimal 

Shift Left Double Decimal and Set 

Shilt Left Double Alpha 

Shift Left Double Alpha and Set 

ShiU Left Triple Decimal 

Shift Left Triple Decimal and Set 

Shift L<>ft Triple Alpha 

Sliifl Lpfl Triple Alpha and Set 

Siuft Left Quadru|)le Decimal 

S!hH Left Quadruple Decimal and Set 
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Mnemonic 


Octal 


SRTD 


22 


SRTDS 


22 


SRTA 


22 


SRTAS 


22 


SRQD 


22 


SRQDS 


22 


SRQA 


22 


SRQAS 


22 


SLSD 


22 


SLSDS 


22 


SLSA 


22 


SLSAS 


22 


SLDD 


22 


SLDDS 


22 


SLDA 


22 


SLDAS 


22 


SLTD 


22 


SLTDS 


22 


SLTA 


22 


SLTAS 


22 


SLQD 


22 


SLQDS 


22 
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Shift Instructions (Continued) 

Shift Left Quadruple Alpha 

Shift Left Quadruple Alpha and Set 

Rotate Right Single Decimal 

Rotate Right Single Decimal and Set 

Rotate Right Single Alpha 

Rotate Right Single Alpha and Set 

Rotate Right Double Decimal 

Rotate Right Double Decimal and Set 

Rotate Right Double Alpha 

Rotate Right Double Alpha and Set 

Rotate Right Triple Decimal 

Rotate Right Triple Decimal and Set 

Rotate Right Triple Alpha 

Rotate Right Triple Alpha and Set 

Rotate Right Quadruple Decimal 

Rotare Right Quadruple Decimal and Set 

Rotate Right Quadruple Alpha 

Rotate Right Quadruple Alpha and Set 

Rotate Left Single Decimal 

Rotate Left Single Decimal and Set 

Rotate Left Single Alpha 

Rotate Left Single Alpha and Set 



VInemonic 


Octal 


SLQA 


22 


SLQAS 


22 


RRSD 


22 


RRSDS 


22 


RRSA 


22 


RRSAS 


22 


RRDD 


22 


RRDDS 


22 


RRDA 


22 


RRDAS 


22 


RRTD 


22 


RRTDS 


22 


RRTA 


22 


RRTAS 


22 


RRQD 


22 


RRQDS 


22 


RRQA 


22 


RRQAS 


22 


RLSD 


22 


RLSDS 


22 


RLSA 


22 


RLSAS 


22 
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Shift Instructions (Continued) 
Rotate Left Double Decimal 
Rotate Left Double Decimal and Set 
Rotate Left Double Alpha 
Rotate Left Double Alpha and Set 
Rotate Left Triple Decimal 
Rotate Left Triple Decimal and Set 
Rotate Left Triple Alpha 
Rotate Left Triple Alpha and Set 
Rotate Left Quadruple Decimal 
Rotate Left Quadruple Decimal and Set 
Rotate Left Quadruple Alpha 
Rotate Left Quadruple Alpha and Set 
Shift Right Single (Binary) 
Shift Rigiit Single (Binary) Test 
Shift Right Double (Binary) 
Shift Right Double (Binary) Test 
Rotate Right Single (Binary) 
Rotate Right Single (Binary) Test 
Rotate Right Double (Binary) 
Rotate Right Double (Binary) Test 



Mnemonic 


Octal 


RLDD 


22 


RLDDS 


22 


RLDA 


22 


RLDAS 


22 


RLTD 


22 


RLTDS 


22 


RLTA 


22 


RLTAS 


22 


RLQD 


22 


RLQDS 


22 


RLQA 


22 


RLQAS 


22 


SRS 


22 


SRST 


22 


SRD 


22 


SRDT 


22 


RRS 


22 


RRST 


22 


RRD 


22 


RRDT 


22 



Conipare Instructions 

Compare Alphanumeric Accumulator to Memory 

Compare Decimal Accumulator to Memory 

(2A) Compare Memory to Immediate 

(2A) Compare Index to Immediate 

(2 A) Compare Second to First Memory 

(2A) Compare Index to Memory 

Sraiich Instructions 



Branch Unconditionally 
(2A) Store Program Counter and Branch 
(2 A) Program Counter to Index and Branch 

'Braiicli if Equal 

3ra ich if Less 

3ra:ic)i if Greater 
(2A) j3ra ich on Count 
(2 A) i3ra ich on Index Count 

J3ra ich Counter 

IJraiich if Zero 

Rrancli if Minus 



Mnemonic 


Octal 


CAA 


03 


CD A 


02 


CMI 


01 


cxr 


01 


CMM 


04 


CXM 


04 



Mnemonic 


Octal 


BRU 


10 


SPB 


17 


PXB 


17 


BRE 


13 


BRL 


14 


BRG 


12 


BRC 


16 


BXC 


16 


BCTR 




BRZ 


15 


BRM 


11 
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Logical Instructi ons 
(2A) AND to Memory 
(2 A) AND to Index 
(2A) OR Inclusive to Memory 
(2A) OR Inclusive to Index 
(2A) OR Exclusive to Memory 
(2A) OR Exclusive to Index 

Edit 

Cen tral Processor Instructions 
i2A) Central Processor Operation 
(2A) Set Status by ANDing 
(2A) Set Status by ORing 
(2 A) Set Status by Loading 
(2A) Request Status of Processor 



Mnemonic 


Octal 


Miscellaneous Instructions 


ANM 


24 (2 A) General 


ANX 


24 


Halt 


RIM 


23 


Load Accumulator Location and length 


RIX 


23 


Store Accumulator Location and length 


RXM 


25 


Exjjlode 


RXX 


25 


Implode 


EDT 


05 


Low Bit Test 

Reset Accumulator Length Single 


Mnemonic 


Octal 


Reset Accumulator Length Double 


CPO 


67 


Reset Accumulator Length Triple 


SSA 


67 


Reset Accumulator Length Quadruple 


SSO 


67 


Index 


SSL 


67 


Index Pointer 


RQSP 


67 


Index Link 

Lidex Indirect 

Index Pointer Indirect 

Index Link Indirect 

Operand 

Operand Pointer 

Operand Link 

Indirect Address Word 



Mnemonic 


Octal 


GEN 


07 


HLT 


00 


LAL 


3'3 


SAL 


37 


EXP 


2D 


IMP 


21 


LBT 


22 


RALS 


22 


RALD 


22 


RALT 


22 


RALQ 


22 


X 


00 


XP 


01 


XL 


02 


X* 


10 


XP* 


11 


XL* 


12 


o 


CO 


OP 


CI 


OL 


C'2 


lAW 


00 
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Miscellaneous Instructions (Continued) Mnemonic 

Data Control Word Character Count DCWC 

Data Control Word Word Count DC WW 
List Pointer Word LPW 

Input/ Output Commands 

All Input/Output Commands are Two- Address Instructions. 



Common to All Peripheral s 
Request Status 
Reset Status 

Card Reader 
Read Card Decimal 
Read Card Binary 
Read Card Mixed mode 

Card Punch 

Punch Card Decimal 

Punch Card Binary 

Punch Card in Edited mode 



Octal 



Mnemonic 


Command 


RQS 


00 


RSS 


40 


Mnemonic 


Command 


RCD 


02 


RCB 


01 


RCM 


03 


Mnemonic 


Command 


PCD 


12 


PCB 


11 


PCE 


13 



P "in I er 

P"in( in the Edited mode (data controls slewing) 

Print in the Edited mode-slew Single line 

P -int in the Edited mode- slew Double line 

P-int in the Edited mode to Top of page 

P "int in the Non-edited mode-slew no lines 

P 'int m the Non-edited mode-slew Single line 

P,-int in the Non-edited mode-slew Double line 

P -int in the Non-edited mode-slew to Top of page 

Slew Printer Single line 

Slew Printer Double line 

Slew Printer to Top of page 

0< ms I )le Typewriter 

Jlcqui'st Status of Typewriter 

Jii'sei Status of Typewriter 

T\pe Input-Octal 

Type Input-Alphanumeric 

Txpe Output-Octal 

Tipe Output-Alphanumeric 



Mnemonic 


Command 


PRE 


30 


PRE3 


31 


PRED 


32 


PRET 


33 


PRN 


10 


PRN3 


11 


PRND 


12 


PRNT 


13 


SPRS 


61 


SPRD 


62 


SPRT 


63 


Mnemonic 


Command 


RQST 


00 


BSST 


40 


no 


01 


HA 


03 


TOO 


11 


TOA 


13 
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Paper Tape 

Read Paper Tape 

Punch Paper Tape 

Punch Edited Tape-system mode 

Punch Single character mode Tape 

Punch Double character mode Tape 

Magnetic Tape 

Read Tape Binary 

Read Tape Decimal 

Write Tape Binary 

Write Tape Decimal 

Write End of File 

Backspace one Record 

Backspace one File 

Set Density Low 

Set Density High 

Forward Space one Record 

Forward Space one File 

Rewind 

Rewind and Standby 

Erase 



Mnemonic 


Command 


RPT 


02 


PPT 


11 


PET 


31 


PST 


16 


PDT 


13 


Mnemonic 


Command 


RTB 


05 


RTD 


04 


WTB 


15 


WTD 


14 


WEF 


55 


BSR 


46 


BSF 


47 


SDL 


61 


SDH 


60 


FSR 


44 


FSF 


45 


RWD 


70 


RWS 


72 


ERS 


54 



Disc Storage Unit 

Seek/Write File 

Seek/Write File and Release seek 

Seek/ Write File and Increment address 

Seek/Write File and Verify 

Seek/Read File 

Seek/Read File and Release Seek 

Seek/Read File and Increment address 

Seek/ Compare 

Read Buffer 

Read File Continuous and Release seek 

Write Buffer 

Write File Continuous and Release seek 

Accept Buffer Address 

Write File Continuous, Verify and release seek 

Seek File 

Seek/Link 

Load Buffer For Compare 

Move Data 

Write File 

Write File and Release seek 

Write File and Increment address 

Write File and Verify 



Mnemonic 


Command 


SWF 


10 


SWFR 


11 


SWFI 


12 


SWFV 


13 


SRF 


14 


SRFR 


15 


SRFI 


16 


SCPR 


17 


RB 


24 


RFCR 


25 


WB 


30 


WFCR 


31 


ABA 


32 


WFCV 


33 


SF 


34 


SLNK 


35 


LBFC 


36 


MVDT 


37 


WF 


•50 


WFR 


51 


WFI 


52 


WFV 


53 
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Disc Storage Unit (Continued) 

Read File 

Read File and Release seek 

Read File and Increment address 

Compare 

Link 



Mnemonic Command 



RF 


54 


RFR 


55 


RFI 


56 


CPR 


57 


LNK 


75 



Document Handler 
Read Document 
Feed Document 
Pocket Document 



Mnemonic Command 

RDOC 01 

FDOC 41 

PDOC 43 



Table 1. Shift Mnemonics For Characters 



s 


R 


S 


A 


S 


SHIFT 


RIGHT 


SINGLE 


ALPHA 


SET 


D 










ACCUM 






DOUBLE 




LENGTH 


R 


L 


T 


D 


A 


ROTATE 


LEFT 


TRIPLE 


DECIMAL 


NO ACCUMU- 


Q 






QUADRUPLE 




LATOR LENGTH 
CHANGE 
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Table 2. Shift Mnemonics For Binai 



S 
SHIFT 


R 

RIGHT 


S 
SINGLE 


T 
TEST 


R 
ROTATE 


D 
DOUBLE 


A 

NO TEST 



Using these two tables, the programmer 
can form any of the Shift Mnemonic 'Op- 
eration Codes. 



COMPLEMENTARY INSTRUCTION WORDS 

In order to accomplish their function, certain GE-423/435 instructions 
require information in addition to that contained within the instruction 
word. The words supplying this additional data are called complementary 
mstruction words. Such words must be provided in the proper format 
when using the instructions requiring them. 

The basic assembly language includes tlie mnemonic operation codes 
designed to form the complementary instruction words. These mnemonic 
codes are described on the following pages. 



BRANCH COUNTER 



BCTR 



Function 



BCTR enables the programmer to specify the count required by the 
Branch on Index Count (BXC) and the Branch on Count (BRC). 
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Format 



BCTR may contain 

• A symbol or blanks as the Reference Symbol 

• BCTR as the operation 

• An expression in the Operation Parameters for the count of the branch 
counter. 

Assembly' Action 

If there is a Reference Symbol, it is defined as the current value of the 
location counter. A branch counter is formed by using the value of the 
expression in the Operation Parameter as the count. 

Example 













'■ ' 








^ = 




J'.'vJ., 


Vi„ 


■'3 


2A 


PICTURE 
26 










1 ti 




i — 1 

.-..pH 

— \ — 






A,-, ; . . . 








A i 1 












— .— -— ^^ 


L D.X 


! 




T.Fl.SiCT.R.. .3, , 




L X I 






|:> .^ . -.-. 






S_.LJ..1A&, 

1,. _ 1 1 . . 


A.l.i,x!... 
B|XX, 





This coding causes 100 words of data to be moved from a work area in 
memory, WRKAR, to a table in memory, TABLE 1. The SETTAB cod- 
ing is executed once before the BXC command is encountered and 99 add- 
itional times on the BXC command. The BCTR controls the associated 
BXC command. 

Notes 



2. 



The Branch Counter specifies the number of times that the associ- 
ated BXC or BRC will branch before falling through to the next 
instruction. 

The largest value which a Branch Counter can contain is 511. 
Therefore, if the value specified for a Branch Counter exceeds 
511, it will be truncated modulo 512. 
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3. The value that results from calculating the expression in Ihe Op- 
eration Parameters, must be absolute (See Relocation Errors, 
page 1-35.) 

4. The Operation Parameters may not contain external global 
symbols. (See Local and Global Symbols, page 1-31- ) 



MOVE COUNTER 



MCTR 



Function 



MCTR enables the programmer to specify the count required by the Move 
(MOV) and the Move or Index Control (MXC) instructions. 

Format 

MCTR may contain 

1. A symbol or blanks as the Reference Symbol 

2. MCTR as the operation 

3. An expression in the Operation Parameters for the address. 

4. An expression in the Operation Parameters for the count of the 
Move Counter. 

Assembly Action 

If there is a Reference Symbol, it is defined as the current value of the 
location counter. A Move Counter is formed using the first expression 
in the Operation Parameters as the Address Filed, and the value of the 
second expression as the count of the number of words to be moved. 
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Example 























refere:nce sym 


30L 


OPERATION 
1 




OPERA r [ON 


"ARAMET ERj 




HA TA NAME 
9 


16 


17 


^f 19 


^-0 


s 


22 




24 


PICTURE 




A 




£ '9 u 


— 










) , o,r^ 




-T,A,e ,1 .!., 1 












f>. , , , 


l 


T^£l^a,.C-C.R 


1 


M c.-r R 










w 


R .k.A iR,j .^ 






















, 


1 . , 












1 1 > . 






1 














, 




1 5^^j:_i.e.xii. 










T 


.f^S^kuA.±, . 




1 


I , \ : , 


i 


___ 


1. 


P 






I 


J?JLCiX,g.._., 


, ^' 



This coding causes 100 words to be moved from a work area in memory, 
WRKAR, to a table in memory, TABLE 1.. The MCTR supplies the address 
from which data is moved and controls the number of words moved. 



Notes 



1. The largest number of words which can be moved using a Move 
Counter is 512. Therefore, if the value specified for a Move 
Counter exceeds 512, it will be truncated modulo 512. 

2. The value that results from calculating the expression for the 
count must be absolute. (See Relocatable Errors, page 1-35.) 

3. The expression for the address may contain external global 
symbols, the expression for the count may not. (See Local and 
Global Symbols, page 1-31 . ) 



LIST POINTER WORD 



LPW 



Function 



LPW enables the programmer to specify the list pointer words which 
indicate the location and size of associated data control lists. 

P'ormat 



LPW may contain 

• A symbol or blanks as the Reference Symbol 
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• LPW as the Operation 

• An expression in the Operation Par;ameters for the address 

• An expression in the (Iteration Parameters for the count of 
the List Pointer Word. 

Assembly Action 

If there is a Reference Symbol, it is defined as the current value of 
the location counter. A List Pointer Word is formed using the first 
expression in the Operation Parameters as the Address Field of the 
LPW and the value of the second e3Q)ression as the count of the num- 
ber of words in the assbciated data control list. 

Example 



REFERENCE SVMBO>, 


OPERATION 

1 


C'PERATION =AWAMfiTEP-. 


DATA NAME 
9 1ft 


17 


LEVEL 
iS IB 


?0 


\» 




24 


p rc T U R E 


• 1 1 1 1 1 1 


UP.M. 












.L,i,5,T ,J ,_, ,7 





















The data control list is at symbolic location LISTl and contains seven 
words. Note that the two expressions in the Operation Parameters 
field are separated by a comma. 



Notes 



1. A single data control list may not contain more than 512 words. 
If the value specified for the count of an LPW exceeds 512, it 
will be truncated modulo 512. 

2. The value that results from calculating the expression for 

the count must be absolute (see Relocation Errors, page 1-35). 

3. The expression for the address may contain external global 
symbols; the expression for the count may not (see Local and 
Global Symbols, page 1-31). 

4. The count in an LPW should be the count of the DCW's +1. 
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DATA CONTROL WORDS 



DCWC-DCWW 



Notes 



The DCWC contains a character count while the count in the 
DCWW is a word count. 



Function 

DCWC (Data Control Word-Character Count) and DCWW (Data Control 
Word- Word Count) enable the programmer to construct input and out- 
put data control lists by indicating the individual data control words 
which comprise such lists. 



2. A single DCW cannot control more than 512 characters. If 
the value specified for a DCW count exceeds 512, it will be 
truncated modulo 512. 

3. The value that results from calculating the expression for 

the count must be absolute (see Relocation Errors, page 1-35). 



Format 



DCWC and DCWW may contain 



4. The expression for the address may contain external global 
symbols; the expression for the count may not (see Local 
and Global Symbols, page 1-31). 



• A symbol or blanks as the Reference Symbol 

• DCWC or DCWW as the Operation 

• An expression in the Operation Parameters for the address 

• An expression in the (deration Parameters for the count of 
the data control word. 



ADDRESS MODIFICATION SEQUENCE WORD 



Assembly Action 



Function 



If there is a Reference Symbol, it is defined as the current value 
of the location counter. A data control word (DCW) is formed using 
the first expression in the Operation Parameters as the Address Field 
of the DCW and the value of the second expression as the DCW char- 
acter count. (The assembler multiplies the DCWW count by four 
before using it as a character count. ) 



X (Index), XP (Index Pointer), and XL (Index Link) enable the pro- 
grammer to specify Address Modification Sequence (AMS) words 
and to indicate their class. (Address Modification is discussed in 
detail in the GE-42y435 Reference Manual. ) 

Format 



Example 



X, XP, and XL may contain 



D ,C W W 

D :c .w:c 

D it :W,(_ 

D ;c..w.W 
LiP Mi 



OT 



r. ,i>_.L;..T 
I ,« J"- .U il 
2.,N iP lU.T 

I ,i ,T .1 












J. ft, 



,0 T. 

U T.- 



,>J.O,<:jl_.._JLtikJ. jL.l.J 



.N.PlU.T.'^ 7. 



.1 .Wip 
lliU.P 
II.N.P 






Note that the expressions in the Operation Parameters field are 
separated by commas. 



. 1 

,3 
XH 

.. ,'y . 
■J.o 



At.W.T. 
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• A symbol or blanks as the Reference Symbol 

• X, XP, or XL as the operation 

• An expression in the Operation Parameters for the address. 

• If desired an expression in the Operation Parameters for the 
address control of the AMS word. 

Assembly Action 

If there is a Reference Symbol, it is defined as the current value 
of the location counter. An AMS word is formed using the first ex- 
pression in the operations Parameters as the Address Field of the 
AMS word. If there is a second expression, it is used as the Address 
Control field of the AMS word. The class is established by the mnemon- 
ic operation code employed by the programmer. 
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Examples 



REFtrp. EMCE SVMSOl. 



!A^^D,J^¥^y^ 







- 






OPERA'; tiN ■rtPAMF 


' c ■^ s 


-V EL 

19 20 




" 


■^ 


2* 


P 1 c - U •=! f: 

2P 






X 






JLA^X^£^^ _^ . ^ . 

















Example 1 forms an AMS Index whose address is RATE and whose 
Address Control Field specifies continuation MODIFY is defined as 
the location of the AMS word. 



::_! }:it:._:jx|4 ^^TX^: 



Example 2 forms an AMS Index Pointer whose address is RATE. 
3. 

Example 3 forms an AMS Index Link whose address is MODIFY. 
4. 



-J ; I !._ 



X:*^,. 









Example 4 forms the same AMS words as example 1, 2, and 3; how- 
ever, the Indirect Address Indicator is set forth in each of the AMS 
words. Refer to the GE-425/435 Reference Manual. 



Notes 



1. For documentation purposes, these instructions should be 
left-justified in the second half of the operation columns of 
the coding form. 

2. If any other value besides 7 is specified for the Address 
Control Field, continuation will not take place. Values 
greater than 7 are truncated modulo- 8. Such values will 
cause a flag to appear on the appropriate line in the assembly 
listing. 
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3. The value that results from calculating tlie expression for the 
address control must be absolute. (See Relocation Errors, 
page 1-35. ) 

4. The expression for the address may contain external global 
symbols; the expression for the address control may not. (See 
Local and Global Symbols, page 1-31. ) 



SECOND ADDRESS SEQUENCE WORDS 



Function 

O (Operand), OP (Operand Pointer) and OL (Operand Link) enable the 
programmer to specify Second Address Sequence (SAS) words and to 
indicate their class. 

Format 



O, OP, and OL may contain 

• A symbol or blanks as the Reference Symbol 

• O, OP, or OL as the operation 

• An expression in the Operation ParEimeters for the address of the 
SAS word. 

Assembly Action 

The Reference Symbol, if any, is defined as the current value of the lo- 
cation counter. An SAS word is formed using the ejqiression in the oper- 
ation Parameters as the Address Field of the SAS word. The class is 
sxtablished by the mnemonic operation code employed by the programmer. 

Examples 



REFERENC E SYMBOL 


OPEFIATION 
1 


OPEK*TIDN PARAMETERS 


DATA NAME 
» 1ft 


17 


LEVEL 
IB 19 


20 


s 

c 


22 


E 


24 


25 il'lCTi.'RE 


1 1 1 . t__.J 1 





1 


Lij^_ 








^ ' ■ ■ ' 



Example 1 forms an SAS operand. 
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2. 


REFERENCE SYMBOL 


OPERATION 
1 


OPERATrON PARAMETERS 




DATA NAME 
9 IB 


17 


LEVEL 
IB 19 


20 


S 


22 


E 


24 


2B 




PICTURE 




fl,D,fi,2, , , , 


— 


' 







P 






?,fi 


,T 


f., , . , 

























Example 2 forms an SAS operand Pointer whose address is RATE. 
ADR2 is defined as the location of the SAS word. 







- - ■ ■'- ;— 


^1 








, 




1, 






a.n.R.cL, , , 


1.. ^ 


U-_^.^ ^_.__L_ 


. .. _ i.„ _ _ 






■ 




1 1 



Example 3 forms an SAS operand Link whose address is ADR2. 
Notes 

1. For documentation purposes, the mnemonics for these in- 
structions should be left-justified in the second half of the 
operation. 

2. The value that results from calculating the expression for 
the address control must be absolute (see Relocation Errors, 
page 1-35). 

3. The expression for the address may contain external global 
symbols; the expression for the address control may not 
(see Local and Global Symbols, page 1-31). 



INDIRECT ADDRESS WORDS 



lAW 



Function 

lAW enables the programmer to specify Indirect Address Words. 

Format 

lAW may contain 

• A symbol or blanks as the Reference Symbol 

• lAW as the operation 

• An expression in the Operation Parameters for the address. 

• An expression in the Operation Parameters for the address control 
of the lAW. 
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Assembly Action 

If there is a Reference Symbol, it is defined as the current value of the 
location counter. An Indirect Address Word is formed using the fii'st ex- 
pression in the Operation Parameters as the Address Field of the lAW. 
If there is a second expression, it is used as the Address Control Field 
of the lAW. 



Examples 



1. 



REFERENCE SYMBOL 


OPERATION 

1 


OPERATION F'ARAMI r EPS 


DATA N-AM E 
9 16 


17 IB 19 


20 


C 


22 


"s 

E 


24 


P 1 C T U R F 





It^Lkl 












K.h.l.i. 


1 1 1 1 1 . 1 


1 ^ 












> ■ ■ 1 1 



Example 1 forms an Indirect Address Word whose address is RATEI. 
2. 



, 1 1 


, , , 1 : , 














li\.^ 








fi.r1 


T.f, 


O--^- 

















Example 2 forms an Indirect Address Word whose address is RATE and 
whose Address Control Field specifies continuation. 



Notes 



1. If the value specified for the Address Control Field is other than 
7, continuation will not take place. Values greater than 7 are 
truncated modulo-8. Such values will cause a flag to appear in the 
appropriate line on the assembly listing. 

2. TTie value that results from calculating the expression for the 
address control must be absolute (see Relocations Errors, 
page 1-35). 

3. The expression for the address may contain external global, 
symbols: the expression for the address control may not (see 
Local and Global Symbols 1-31). 



1-65 



12/6/63 



INPUT/OUTPUT MNEMONIC OPERATION FORMATS 

The Basic Assembly Language separates the input/ output operation codes 
into two broad classes according to IJie information which must be supplied 
in the Operation Parameters. The first class consists of those instructions 
which involve cliannel, device and Address Control. The second class 
consists of those instructions which involve only the Address Control. 
(Refer to Basic Input/Output System manual. ) 



CLASS 1 



INPUT/ OUTPUT MNEMONICS 



Function 

Class 1 contains all instructions which deal with input/ output devices other 
than the console typewriter. 

Format 



A Class 1 instruction may contain 

• A Symbol or blanks as the Reference Symbol 

• A Class 1 mnemonic operation code as the operation 

• An expression in the Operation Parameters for the channel 

• An expression in the Operation Parameters for the device 

• An expression in the Operation Parameters for the address control 
of the Class 1 instruction. 

Examples 



1. " 



EFERENCE SYMBOL 



OPERATION 



OPERATION PARAMETERS 



DATA NAME 



2 C; 2 2 



PICTURE 



_l I I L_ 



hITlRI 



i^^i^_^u2x 



Example 1 shows a Read Tape Binary command to Channel 1, magnetic 
tape unit 2. Status is stored in fixed index register 3. 























1? 


T,B 














I t 1 1 1 1 











V 






H ,i5),/_,S.r.A .T 


1 1 ; 1 1 J ^ 




1 












..- „J 1 L— _J 1 1 1 , 1 1 1 1 



Example 2 shows a Read Tape Binary command to Channel 1, magnetic 
tape unit 2. The operand pointer sends status to HOLSTAT. 
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REFERENCE SYMBOL 


OPERATION 

r 


OPERATION PARAMETERS 1 


DATA NAME 

9 le 


17 


LEVEL 

18 19 


20 


V 

C 


22 


E 


2'l 


PICTURE 


1 1 !_., -J I \ 1 


Mt^ 














1 1 i 1 J . 1 , 








X 


P 






T).k.</ :\ ,C,£ 


< 1 1 > 1 > 1 




J ; 


<;?* 


V 






H,(^:L.S,T.A.r. . . . , . 






, 


ij 




_ 







Example 3 shows a Read Tape Binary command to Channel 1. The index 
pointer establishes a device code. The operand pointer sends status to 
HOLSTAT. 



.!;;;;; -^—^ 


Srr'El"' 


— f— 4- 




-J L,-^ 








^ztz 


CH.A N AIR.L. , , 




* 






d-p' 1 


H,0,L S,T,A-T, , , 












-' ' ' h 


■ 




1 








Example 4 shows a Read Tape Binary command to magnetic tape unit 2. 
The index pointer establishes the channel. The operand pointer sends 
status to HOLSTAT. 



5. 





fi_r,a 






f- 






y 


1 




, 




^p 






C, H, A,/\/.H/.f .L , . 


,7 










Kf 






Ci.e ,v, 1 iCf . , ' 











fiP 






H,;if,L,S,T,f T 























Example 5 shows a Read Tape Binary command. The first index pointer 
establishes the channel; the second the device code. The operand pointer 
sends status to HOLSTAT. 



Moles 



1. Expressions in the Operation Piirameters must be separated by 
commas. The number of commias which precede a particular 
expression establish its function. Thus, an expression for the 
device must always be preceded by one comma and an expression 
for the address control by two commas. 

2. The value that results from calculating thie expression for the 
channel, device and address control must be absolute (see Re- 
location Errors, page 1-35). 
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3. External global symbols may not be used in the Operation Para- 
meters (Local and Global Symbols, page 1-31). 



CLASS 2 



INPUT/OUTPUT MNEMONICS 



Function 

Class 2 input/output mnemonics contains all instructions which deal with 
the console typewriter and the central processor channel. 

Format 



A Class 2 instruction may contain: 



• A symbol or blanks as the Reference Symbol 

• A Class 2 mnemonic operation code as the Operation 

• An expression in the Operation Parameters for the address control 



2. 



REFERENCE S Y M B O U 


OPERATION 


OPERATION PAR*MET£:RS 


O.TA.^^E ^^ 


L El V E L 
17 \if 19 20 


s 
y 
c 


22 


E 


24 


PICTURE 
28 




1 , t 1 1 1 1 ■ 1 1 1 




i 1 ' 


9( 


P 






H.j2^,L ,^,T,A .Ti. ■ ■ 1. j—L 




1- 














--j . , 










1 i i_ -i 1- -i L 






- 








1 , , 




^- • ■ ■ ■ - 






1 1 1 1 1 1 1 -i_ i 1- -L >— 


,- , 1 ■, : : ^ 


Jf^? .,-..,.- 


Jii^aj.^ J-Ua^T'. a__^_^..^.^-. 



Example 2 shows two Class 2 commands, a Type Output Alphanumeric 
and a Request Status of Processor. The Operand Pointers send status 
to HOLSTAT. 



Notes 



of the Class 2 instruction. 



1. The value that results from calculating the expression for the 
address control must be absolute (see Relocation Errors, 
page 1-35). 

2. External global symbols may not be used in the Operation Para- 
meters, (see Local and Global Symbols, page 1-31). 



Examples 



1. 



f?EFEREMCF. SYMBOL 


OPERA 


TION 




OPERA-' 


■ OS P A« ft ^^ 


- E.P.'- 


DATA NAME 
9 Ife 


17 




£0 


S 


32 


E 


24 


25 




P I C T U R F. 




L.._i -.-1 — L _J. 1-__1 


-^l>f:Pl 




1 






^, , , , 




. ! 












._.i_..^.„x. _^„a_.x_.^.- 


1 


-- 


















1 1 1 ■•- 
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Example 1 shows two Class 2 commands, a Type Output Alphanumeric 
and a Request Status of Processor, which sends status to fixed index 3. 
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VI. PSEUDO- OPERATIONS 

Pseudo- operations are mnemonic codes which have the same general 
form as computer operations; however, they perform their function dur- 
ing the running of the assembly and are never executed by the computer 
as machine instructions. These instructions are used to control and in- 
struct the assembly of a program. 

Pseudo-operations may be used to communicate with the various portions 
of the GE-425/435 software system, to indicate constants, to influence 
memory assignments, to annotate the assembly listing etc. 

Available pseudo- operations are listed and explained on the following 
pages. 

SYSTEM ORIENTED PSEUDO-OPERATIONS MNEMONIC 

Segment Name SGMT 

Define Internal Global symbols DIG 

Define External Global symbols DXG 

Define Global Reference Remotely DGRR 

Define Global Reference Ends DGRE 

Define Global Reference DGR 

Equals Global symbol EQUG 

Call segment at load time CALL 

Include Library segment INCL 

Include Symbolic segment INCS 

Block Started by Symbol in the Loader area BSSL 

Block Preceded by Symbol in the Loader area BPSL 

Last Symbol in Block in the Loader area LSBL 

Accumulator Reference Point in the Loader area ARPL 



1-71 



12/6/63 



MEMORY ALLOCATION PSEUDO-OPERATIONS MNEMONIC 

Block Started by Symbol BSS 

Block Preceded by Symbol BPS 

Last Symbol in Block LSB 

Accumulator Reference Point ARP 

Accumulator Reference Point in the Loader area ARPL 

Accumulator ACUM 

Fill word FILL 

CONSTANT PRODUCING PSEUDO-OPERATIONS MNEMONIC 

Decimal Constant Single word DECS 

Decimal Constant Double word DECD 

Decimal Constant Triple word DECT 

Decimal Constant Quadruple word DECQ 

Alphanumeric constant AN 

Last Symbol Alphanumeric LSAN 

Octal Constant Single word OCTS 

Octal Constant Double word OCTD 

Octal Constant Triple word OCTT 

Octal Constant Quadruple word OCTQ 
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ASSEMBLY OUTPUT CONTROL PSEUDO-OPERATIONS MNEMONIC 
Title TTL 

Eject page EJT 

Identify binary output IDEN 

Full binary cards FULL 

Symbolic Analyzer SYAL 



MISCELLANEOUS PSEUDO- OPERATIONS 

Origin 

Origin Octal 

Equals 

Equals Octal 

Prefix 

Transfer Control Card 

End of program 



MNEMONIC 
ORG 
ORGO 
EQU 
EQUO 
PRFX 
TCD 
END 



SYSTEM ORIENTED PSEUDO-OPERATIONS 



SEGMENT NAME 



SGMT 



Function 



All segments must be given a unique name to be punched on the out- 
put program header card. (See Section III, Assembly Functions. ) 
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SGMT allows the programmer to name his segments (program) In 
addition, SGMT allows the programmer to specify an absolute origin 
for the segment, thus giving him the ability to assemble in the absolute 
mode. 

Format 



SGMT may contain 

• The segment name as the Reference Symbol 

• SGMT as the operation 

• An expression or blanks in the OiDeration Parameters. 

Assembler Action 

When the assembler recognizes the SGMT pseudo- operation, it isolat(!s 
the segment name and retains it for the program header card. 

The Operation Parameters can contain three types of entries: 

1. Blanks : Blanks in the Operation Parameters indicate the 
relocatable mode of assembly. All instructions are assem- 
bled relative to zero; the assembly listing is relative to zero; 
relocatable errors are flagged. 

2. An expression containing one external global symbol; In add- 
ition to the general restrictions placed on external global 
symbols on page 1-79, the external global must be either pre- 
ceded by a plus sign, or the plus sign must be implied. The 
condition, then indicates the relocatable mode of assembly. 

3. An absolute decimal value: Because the absolute value is by 
definition the origin of the segment (program), its presence 
indicates the absolute mode of assembly. All instructions 
are listed relative to the starting origm. Relocatable errors 
are flagged for warning purposes only, since the program can 
be moved by changing the starting address on the origin. 

Restriction 

SGMT must be the first card of every segment or program that is pre- 
sented for assembly. In addition, if the segment is to be placed in the 
library, it must be given a unique name. This will insure that both 
the assembler and librarian will be able to locate the segment at some 
future time. 
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Example 



1. 
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The programmer indicates that the name of the segment is GROSPAY. 
Further, since the Operation Parameter field is blank, a relocatable 
assembly is indicated. 
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The programmer indicates that the name of the segment name is FISCAL. 
Since the Operation Parameter field contains a symbolic reference (by 
definition, an external global symbol), a relocatable assembly is indicated. 
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The programmer indicates that the segment name is TIMCAL. Since the 
Operation Parameter field contains a decimal value, an absolute assembly 
is indicated. 



DEFINE INTERNAL GLOBAL SYMBOL 



DIG 



Funct ion 

DIG indicates those symbolic global references which are defined within 
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the segment being assembled. The names of these references are re- 
(|uired at load time to insure that separately compiled segments are 
])roperly linked. 

Format 

DIG must contain 

« DIG as the Operation 

w Internal global references that are listed in the Operation Parameters. 
These symbolic references must be eight characters or less. They 
must be separated by a comma. 

II All internal global symbols listed must also be found in the Refer- 
ence Symbol field. 

Assembler Action 

'^en the assembler encounters a DIG, the Operation Parameters are 
scanned and each symbolic reference is stored on the symbol table with 
a unique flag that defines it as an internal global symbol. 

Example 
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By using DIG, the three symbols, FICA, SALARY, and INSUR, are set 
lorth as internal global symbols. Tliey will be entered on the symbol . 
table and marked as such. At the end of Pass I of the assembler, each 
internal global symbol together with its value and type (absolute or 
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relocatable) is punched into an internal global card so that the loader 
can effect the proper linkage among segments at load time. 

Note 

DIG should appear near the beginning of the program deck with the other 
pseudo-operations that effect linkage. When DIG is used in this way, the 
coding will contain centralized documentation which describes the inter- 
action between segments. 



DEFINE EXTERNAL GLOBAL SYMBOLS 



DXG 



Function 

DXG must contain 

• DXG as the operation 

• A list of external global symbolic references that will be found with- 
in the segment in the Operation Parameters. These symbolic re- 
ferences must be eight characters or less. They are separated by 

a comma . 

Ass embler Action 

When the assembler encounters a DXG, the Operation Parameters are 
scanned and each symbolic reference is stored on the symbol table 
with a unique flag that defines it as an external global symbol. 
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Example 
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-- ' ■ 

The three symbols, BONDED, TIME, and PRTCHECK, are declared to 
be External Global Symbols. They will be entered on the symbol table 
and marked as such. At the termination of Pass II of the assembler, 
each external global symbol will appear in the binary output. Further, 
every location within the segment that requires the external global for 
completeness will also be indicated. 



Notes 



All symbols preceded by a lozenge are assumed to be symbols 
which are communicating with the various portions of the 
GE-425/435 software system. When the assembler encounters 
such references in the Operation Parameters, it automatically 
classifies them as external global symbols. For example, 
when a programmer wishes to communicate with the Basic Inpit/ 
Output System such references as D CARD, D TAPE, D TYPE, 
□ DEMND, etc., are all classified as external global symbols. 
ITiey need not be declared as such by a DXG. 
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2. DXG should appear near the beginning of the program decit with 
the other pseudo-operations that effect segment linkage. When 
DXG is used in this way. the coding will contain centralized 
documentation which describes the interaction between segments. 

Restrictions 

The following restrictions must be observed when using external global 
symbols: 

1. The external glol)al symbol may i)e preceded by either a plus 
(+) or a minus {-) sign; no other operators are allowed. If the 
external global symbol is the first term in the Operation Para- 
meters and is not preceded by a sign is implied. 

2. The external global symbol may be followed by a plus (+) or a 
minus (-) sign, or in the case of the last term of an expression 
by a blank or a comma (, ). No other operations are allowed. 

Thus, external symbols may not be used as factors in either multiplica- 
tion or division. The assembly listing will flag any violations of these 
rules. 



DEFINE GLOBAL REFERENCE REMOTELY 



DGRR 



Fun ction 

The DGRR pseudo-operation helps to reduce the number of global symbols 
required for communication between segments. 

One or more of the segments of a program may contain "chains" * of 
data which must be referenced by other segments, for example, the in- 
dividual files of a working storage area. Since, in most cases, segments 



* "Chains" may be defined as related records in a file, which each con- 
tain similar elements of data. For example a Personnel File 



EMPNO 



EMPNAM 



EM CROP AY 
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deal with the individual elements of the chain ratlier than the chain as a 
whole, the segments must be able to referesice each element individually, 
as well as the chain itself. 

"'he normal method of obtaining data from another segment requires that 
an external global symbol be -assigned to each element of such data. How- 
ever there is a limit to the number of external global symbols which the 
loader and the assembler can handle efficiently. Assigning a global symbol 
t) each element in a chain of elements tends to produce a large number of 
External global symbols. 

The pseudo-operation DGRR helps to reduce the number of external global 
symbols required for the efficient operation of a program. 



Consider the following example: 
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The DGRR assigns the global laymbol INR13C to the chain of data which 
follows. Further, it instructs the assembler to define the elements of 
tie chain, EMPNO, EMPNAM and EMGROP AY, as INREC+0, INREC+2 
and INREC+8, respectively. Any time the assembler recognizes a refer- 
ence to an element from the DGRR, it converts that reference to the 
global symbol INREC with the proper increment. 

FDrmat 



DGRR must contain: 

• A symbol as the Reference Symboi 

• DGRR as the Operation. 
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Assembler Action 

When the assembler encounters a DGRR, it realizes that it is dealing with 
a storage allocating section which will be defined in one of the other seg- 
ments (see DGR). This implies that no actual storage allocation will take 
place in the segment that is currently being assembled. 

The Reference Symbol in the DGRR is treated as an external global symbol. 
A new location counter is initiated so that increments from the base external 
global can be calculated. As Reference Symbols are encountered after 
the DGRR, they are placed in the symbol table along with their increment 
and a marker which points at the base external global. This process con- 
tinues until one of the following occurs : 

1. the assembler encounters another DGRR which reinitiates the 
entire process with a new external global, or 

2. the assembler encounters a DGRE (Define Global Reference 
Ends) which terminates the reference area, or 

3. the assembler encounters an END or TCD which terminates 
the assembly, or 

4. the assembler encounters a maehine operation or illegal pseudo- 
operation. Legal pseudo- operations are: BSS, LSB, AN, LSAN, 
OCT (S, D, T, Q), DEC (S, D, T, Q), BPS, TTL, and EJT. 



Example 
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The DGRR indicates that the subsequent block reservation is not defined 
within the segment; therefore, no storage is tci be allocated. The 
symbolic reference WS is treated as a basic external global symbol. 
The symbols: EENO, EMPNAME, and EMPAY, are converted respe.;t- 
ively to WS+0, WS+2 and WS+8. \Mien the instruction at location A is 
converted, the assembler communicates the following information to 
the loader: 

1. An external global symbol (WS) appears at this point. 

2. The value 9 must be added to the value WS since EMPAY+1 
equals (WS+8)+l or WS+9. 

Note 

DGRR should appear near the beginning of the program deck with the 
other pseudo- operations that effect segment linkage. Wlien DGRR is 
used in this way, the coding will contain centralized documentation 
which describes the interaction between segments. 



DEFINE GLOBAL REFERENCE ENDS 



DGRE 



Function 

When a global reference is defined remotely, the programmer must 
indicate when the definition has STOPPED, i.e. , when to resurae nor- 
mal assembly and begin stepping the location counter. DGRE perforris 
this function. 

Format 



DGRE must contain 

• A symbol or blanks in the Reference Symbol 

• DGRE as the Operation 

Assembler Action 

When the assembler encounters a DGRE, it ceases to operate in a re- 
mote mode and begins the normal assembly process. 
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Example 
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Note 

When IK-BE is u:a i, ii s -ili^ayB used with a EMjHH. B«th iiistructians 
should b'-' olac'i d r 'ar tn?; ;)eg;nnjng of the pragrjim deck with other 
pscudo-opsratiiws that effect segment linkage. In this way, the coding 
will contain ceutj-aiized dccumentation which describes the interaction 
between segments. 



defe:>je global reference 



DGR 



Function 

One segment in a program must insure that storage is allocated for 
data that must be available to other segments. The DGR pseudo- 
operation is used to indicate the beginning of common storage in 
this segment. 
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Format 



DGR must contain 

• A symbol in the Reference Symbol 

• rXjR as the Operation 

As semb l er Action 

Mien the assembler encounters a DGR, it automatically classifies the 
Piefererce Symbol as an internal global symbol. The assembly then con- 
rues ii its normal way; subsequent cards contain information about 
siorage which must he allocated 'ivithin tlie current segment. 
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EENO 
EMPNAME 
EMPAY 
B 



Address Assipiment 
(]3ecimal Notati on) 
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1003 

1009 

1011 
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Note 



DGR should appeiir near the beginning of the program deck with the 
other pseudo-operations that effect segment linkage. When it is used 
this way, the coding will contain centralized documentation which des- 
cribes interaction between segments. 



EQUALS GLOBAL SYMBOL 



EQUG 



Function 

EQUG equates a local symbol to an external global symbol. 

Form at 

EQUG must contain 

• A local symbol as the Reference Symbol. 

• EQUG as the Operation 

• An expression containing one external global symbol in the Operation 
Parameters. 

Assembler Action 

The assembler enters the local symbol in the Symbol Table with a flag 
indicating that all references to that symbol are actually referencing 
the external global symbol to which it has been equated. 
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Example 
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Assume that two different programmers were writing separate seg^nents 
of a production program, the following situation might occur. Onei pro- 
grammer might define the symbol for his time calculation routine as 
TIMECAL. The other programmer might refer to tlie sairie routine in 
his segment as CENTIME- 15. Similar referencing might occur with 
PRINT and SYSPRINT. To equate the two sets reference symbols, the 
pseudo- operation EQUG is used as shown. 

The first EQUG instructs the assembler to substitute the external global 
symbol SYSPRINT for the symbol PRINT. The second EQUG instructs 
the assembler to substitute CENTIME- 15 for TIMECAL, i.e., the in- 
struction at symbolic reference LOOP will be treated as if it were 
written: 



LOOP 



LDS 



GEN TIME- 15+20, 2 



which results in 

LOOP LDS GENITME+S, 2 

where CENTIME is now an external global symbol. 
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Note 

EQUG should appear near the beginning of the program deck with the 
other pseudo- operations that effect segment linkage. When it is used 
in this way, the coding will contain centralized documentation which 
describes the interaction between segments. 

Restriction 

The following restrictions must be observed when equating a local symbol 
to an external global symbol. 

1. The external global symbol may be preceded by a plus {+) sign; 
no other operators are allowed. K the external global symbol 
is the first term in the Operation Parameters and is not pre- 
ceded by a sign, the plus sign is implied. 

2. The external global symbol may be followed by a plus (+) or a 
minus (-) sign, or in the case of the last term of an expression, 
by a blank or a comma (, ). No other operations are allowed. 



ASSE MBLER ACTION 

Wnen the assembler recognizes a CALL, it e;rtracts the seg:ment names 
fram the Operation Parameters and places them in the program header 

card. 

Example 



CALL SEGMENT AT LOAD TIME 



CALL 



Function 

Any given segment may contain a CALL pseudo- operation. The CALL 
pseudo-operation indicates that the segments named in the Operation 
Parameters are needed for the successful running of the given segment. 
Li contrast to INCL, CALL indicates that the required segments are 
requested from a library tape and loaded by the loader at execution 
time. 

Format 



CALL must contain 

t CALL as the Operation 

• In the Operation Parameters, the names of the segments which the 
loader is to provide. These names are separated by commas. 
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In this example, the assembler will inform the loader that two previously 
assembled segments are required from the library tape before execution. 
Jn this case, the names of the segments are TTMECARD and BONDEDUC; 
lh}se names are placed on the program header card. 

'n e instruction at location A illustrates one important point, if the symbol 
TIMETPl is assumed to be an entry point in the segment named 
TIME CARD. The name of the segment need not be the same as one of 
its entry points since entry points are defined globals in the "called" 

segment. 

N(;.te 

("ALL should appear near the beginning of the program deck with the other 
pseudo-operations that effect segment linkage. When it is uised in this 
way, the coding will contain centralized documentation whicli describes 
tht! interaction between segments. 
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INCLUDE LIBRARY SEGMENT 



INCL 



In this example, the programmer requests three segments at assembly 
time: lOTAPE, lOCARD and PRINT. These segment names are extraci- 
ed and placed on the program header card. When the segment has been 
assembled, the system tape is searched and the previously assembled 
segments are punched. 



Function 

Any given segment may contain an INCL pseudo operation. The INCL 
pseudo- operation indicates that the segments named in the Operation 
Parameters are needed for the successful running of the given segment. 
In contrast to CALL, INCL causes that the required segments to be 
supplied at assembly time. 

Format 



The instruction location A illustrates one important point if the symbol 
lOl is assumed to be an entry point in the segment named lOTAPE. The 
name of the segment need not be the same as one of its entry points since 
entry points are defined as internal globals within the "included" segmert. 

Note 

INCL should appear near the beginning of the program deck with the 
other pseudo- operations that effect segment linkage. Wlien it is used 
in this way, the coding will contain centralized ducumentation which des- 
cribes the interaction between segments. 



INCL must contain 



• INCL as the Operation 

• In the Operation Parameters, the names of the segments which 
are to be supplied. These names are separated by commas. 







INCLUDE SYMBOLIC SEGMENT 



INCS 



Assembler Action 

When the assembler encounters an INCL, it extracts the segment names 
from the Ojoeration Parameter and places them in the program header 
card. In addition, the system tape is searched for the named routines 
which are then appended to the segment begin assembled. An indica- 
tion is given to the user if the segment cannot be found. 

Example 
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Function 

INCS allows the programmer to specify the names of segments which 
he wishes to have reassembled with his program. Sections of the pro- 
gram library may be kept in syml)olic form and asseml)Ied with the 
current segment. 

Format 



INCS must contain 

• INCS as the Operation 

• In the Operation Parameters, the names of tlie segments which are 
to be assembled with the current program. These names must be 
separated l)y commas. 

As sembler Action 

When the assembler encounters an INCS. it extracts the segment names 
from the Operation Parameters and retains them in a table. At the end 
of Pass I, these symbolic segments are located on the system tape. Thi 
assembler then continues to process these segments just as if they had 
been placed within the programmer's input. 
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Example 
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In this example, the programmer requests two segments at assembly 
time: GROS and PARTS. The INCS pseudo- operation specifies that 
these segments reside on the system tape in symbolic form. At the end 
of Pass I, the system tape is searched and the two segments are located, 
Hiese segments are then assembled with the current segment. 

Note 

INCS should appear near the beginning of the program deck with the other 
pseudo-operations that effect segment linkage. When it is used in this 
•way, the coding will contain centralized documentation which describes 
the interaction between segments. 



BLOCK STARTED BY SYMBOL IN THE LOADER AREA 



BSSL 



Function 

BSSL allows the programmer to allocate storage in the memory that is 
occupied by the loader. BSSL is described under Memory Allocation 
Pseudo- Operations . 



BLOCK PRECEDED BY SYMBOL IN THE LOADER AREA 



BPSL 



BPSL performs a function similar to BSSL. BPSL is described under 
Memory Allocation Pseudo- Operations. 
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LAST SYMBOL IN BLOCK IN THE LOADER AREA' 



LSBL 



LSBL performs a function similar to BSSL. LSBL is described under 
Memory Allocation Pseudo Operations. 



ACCUMULATOR REFERENCE POINT IN THE LOADER AREA ARPL 



ARPL performs a function similar to BSSL. ARPL is described under 
Memory Allocation Pseudo-Operations. 



MEMORY ALLOCATION PSEUDO-OPERATIONS 



BLOCK STARTED BY SYMBOL 



BSS 



Function 

BSS reserves a block of consecutive memory locations and defines a 
Reference Symbol as the first of the re.served locations. 

Format 



BSS must contain 

• A symbol or blanks as the Reference Symbol 

• BSS as the Operation. 

• An expression in the Operation Parameters for the number of words 
to be reserved by the BSS. 

Assembler Action 

The Reference Symbol is defined as the current value of the location 
counter. The location counter is then increased by the value of the ex- 
pression in the Operation Parameter; thus, the assembler reserves a 
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block of memory which is equal in length to the value of the expression. 
The symbol, therefore, represents the first location in the reserved 
block. BSS reserves memory; however, it does not clear the reserved 
area. Therefore, the programmer may not assume that an area reserved 
by a BSS will initially contain zeroes. 

Examples 

Assume that the current value of the location counter is 100. 

1. 
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In example 1, the BSS defines RECA as 1100 and reserves 110 locations 
(1100-1109). 
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In example 2. SIZE equals 100; therefore the BSS reserves 100 locations 
(1110-1209). 
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In example 3, the BSS defines CODE as 210, the current value of the lo- 
cation counter. Since no locations are to be reserved, the location count- 
er remains at 1210. 



Notes 



1. All symbols used in the Operation Parameters of a BSS must 
have been previously defined (see Previously Defined Symbols, 
page 1-1J(). 

2. The result of evaluating the expression ir (.he Operation Para- 
meters must be absolute (see Relocatior. Errors, page 1-35). 



1-93 



12/6/63 



BLOCK STARTED BY SYMBOL IN THE LOADER AREA 



BSSL 



Function 

BSSL reserves a block of consecutive memory locations and defines a 
Reference Symbol as the first of the reserved locations. Unlike BSS, 
the block of reserved locations is not allocated "in line"; the block is 
reserved in the area occupied by the loader. Thus, BSSL allows the 
programmer to make use of the entire computer memory for his applicj.- 
tions because it gives him the facility to overlay the loader. 

Format 



BSSL must contain 

• A symbol as the Reference Symbol 

• BSSL as the Operation 

• An expression in the Operation Parameters for the number of words 
to be reserved by the BSSL. 



Assembler Action 

The expression in the Operation Parameters is evaluated to determine 
the number of words to be reserved. This value and the Reference Symbol 
are placed in the symbol table with a special flag. At the end of Pass I, 
the assembler punches this information so that the storage can be allocated 
when the program is loaded. When the loader reserves this memory, i; 
does not clear the allocated area. Therefore, the programmer must not 
assume that the area reserved by a BSSL will initially contain zeroes. 
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Example 
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In this example, if we assume that. symbol A is assigned to location 7500, 
symbol B will be assigned to location 7502 and symbol D will be assigned 
to location 7503. Symbolic reference IN will be punched in the binary 
deck with an indication that a block of 500 memory locations are to be re- 
served by the loader. The symbol IN will be assigned to the first location 
of this block. 



Symoolic reference OUT will be punched in the binary deck with an indica- 
tion that a block of 100 memory locations are to be reserved by the loader. 
The symbol OUT will assigned to the first location of this block. 

In this example, a block of 500 locations is reserved starting at symbolic 
location OUT. If there are other "loader area" pseudo- operations in the 
program, there is no guarantee that the two blocks of reserved locations 
will be next to each other in memory. Thus, the programmer may not 
assume that IN+500 is location OUT. 

Notes 



3. 



All symbols used in the Operation Parameters of aBSSL must 
have been previously defined (see Previously Defined Symbols, 
page 1-15). 

The results of evaluating the expression in the Operation Para- 
meters must be absolute (see Relocatable Errors, page 1-35). 

BSSL should appear near the beginning of the program deck with 
the other pseudo- operations that allocate storage in the area 
occupied by the loader. Wlien it is used in this way, the coding 
will contain centralized documentation that describes the over- 
lay of the loader. 
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BLOCK PRECEDED BY SYMBOL 



EPS 



Function 

EPS reserves a block of memory locations within a program and defines 
a Reference Symbol as the location which immediately precedes the block. 

Format 



BPS must contain 



A symbol or blanks as the Reference Symbol 

BPS as the Operation 

An expression in the Operation Parjimeter.? for the number of words 

to be reserved by the BPS. 



As sembler Actio n 

[f there is a Reference Symbol, 
value of the location counter. The 



!s defined as one less than the current 
.;:ation counter is then increased by 



;he value of the expresF.ion in the Operation Parameters; thus, a block 
si memory is reserved which is equal in U-ngth to the value of that ex- 
iJ-'cssion. BPS reserves memory; liowever, it does not clear the reserved 
irea. Tfierefore, the programmer may not assume that an area reserved 
!)y a BPS will initially contain >;ero' s, 

Sxaniples 



.\ssume that the current value of tiie location counter is 2000. 
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"hp B.SS definea TABLEl as 2000 andf eserves 10 locations (2000 - 2009). 
"he BPS liefines TABLE2 as 2009 and reserves 10 locations (2010 - 2019). 



1-96 



12/6/63 



REFERENCE SVMBOL 


OPERA 


T,ON 


OPERATION PARAMETERS 


DATA NAME 
S 16 


17 


LEVEL 
IS 19 


.0 


s 


22 


E 


24 


PIC TURF 
25 




f . 










> J , 1 1 1 1 1 I < 1 1 . 1 






- 








' 1 . 1 1 . ■ 1 


- - -i-^-i ' -> - - 


: 1 












I, 


VTi 










r?. . f 1 


D S 


-~ 






— 


1.A ,6 .UiLi 1 i,^..-L_-^--' ^^---. -. 




























-:-■- ■ - 


























. ., „ ^_^_^^_._^ 




















, , , , 







, 




1 




, 



Since TABLEl was defined by a BSS and represents the first location in 
a reserved block, fixed index register 1 must be set to zero if the pro- 
grammer desires to obtain the first item from TABLEl; one if the second 
item is desired, etc. 
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Since TABLE2 was defined by a BPS and represents the location whicli 
precedes the first position of the reserved block, fixed index register 
1 must be set to one to obtain the first item froni TABLE2 ; two tc ob- 
tain the second item, etc. Because TAB LE2 has been defined by a BPS, 
any of the 10 items from the table may be obtained by loading index re- 
gister one with the table position of the desired item. 



Notes 



1. All symbols used in the Operation Parameters of a BPS must 
have been previously defined (see Previously Defined Symbols, 
page 1-15 ). 

2. The result of evaluating the expression in the Qjeration Para- 
meters must be absolute (see Relocation Errors, page 1-JI5). 



BLOCK PRECEDED BY SYMBOL IN THE LOADER AREA 



BPSL 



Function 

BPSL reserves a block of consecutive memory locations and defines a 
Reference Symbol, as the location which immediately precedes that 
block. Unlike BPS, the block of reserved locations is not allocated "in 
line"; the block is reserved in the area occupied by the loader. Thus, 
BPSL allows the programmer to make use of the entire computer 
memory for his applications since it gives him the facility to overlay 
the loader. 

Fo rmat 

BPSL must contain 

• A symbol as the Reference Symbol 

• BPSL as the Operation 

• An expression in the Operation Parameters Cor the number of words 
to be reserved by the BPSL. 
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Asse ;mbl er Ac tion 

The expression in the Operation Parameters is evaluated to determine 
the number of words to be reserved. This value and the Reference 
Symbol are placed on the symbol table with a special flag. At the end 
of Pass I, the assembler punches this information so that the storage 
can be allocated when the program is loaded. When the loader reserves 
this memory, it does not clear the allocated area. Therefore, the 
programmer may not assume that the area reserved by a BPSL will ini- 
tially contain zeroes. 
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In this example, if we assume that symbol A is assigned to location 
7500, symbol B will be assigned to location 7502 and symbol D will be 
assigned to location 7503. 

Symbolic reference IN will be punched in the binary deck with an indica- 
tion that a block of 500 memory locations are to be reserved by the 
loader. The symbol IN will be assigned to the location which immediate- 
ly precedes this block. 

SymboUc reference OUT will be punched in the binary deck with an indi- 
cation that a block of 100 memory locations are to be reserved by the 
loader. The symbol OUT will be assigned to the location which imme- 
diately precedes this block. 
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(n this example, a block of 500 locations is reserved starting at symbolic 
location IN+1 and a block of 100 locations is reserved starting at sym- 
bolic location OUT+1. If there are other "loader area' pseudo- operations 
in the program, there is no guarantee that the two blocks of reserved 
Locations will be next to each other in memory. Thus, the programmer 
may not assume that IN+500 is location OUT. 



^lotes 



1. All symbols used in the Operation Parameters of a BPSL must 
have been previously defined. 

2. The results of evaluating the expression in the Operation Para- 
meters must be absolute (see Relocations Errors, page 1-35). 

3. BPSL should appear near the beginning of the program deck 
with the other pseudo- operations that allocate storage in the 
area occupied by the loader. When it is used in this way, the 
coding will contain centralized documentation that described 
the overlay of the loader. 



.AST SYMBOL IN BLOCK 



LSB 



Fun ction 

LSB is used to reserve a block of consecutive memory locations and to 
assign a Reference Symbol to the last of the reserved locations. 

F ormat 

ijSB must contain 

• A symbol or blanks as the Reference Symbol 

• LSB as the Operation 

w An expression in the Operation Parameters for the number of 
words to be reserved by the LSB. 
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Assembler Action 

The location counter is increased by the value of the expression in the 
Operation Parameters; thus, the assembler reserves a block of memory 
which is equal in length to the value of that expression. The Reference 
Symbol is defined as one less than the value of the location counter, after 
it has been increased. The symbol, therefore, represents the last 
location in the reserved block. LSB reserves memory; however, it does 
not clear the reserved area. Therefore, the programmer may not assume 
that an area reserved by an LSB will initially contain zeroes. 

Exanyle 

Assume that the current value of the location counter is 1100. 
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The LSB reserves four locations (1100-1103) and defines TOTPAY as 1103. 
The BSS defines GROPAY as 1104 and reserves four locations (1104-1107). 
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In the example, the programmer may address the area reserved by the 
I£B symbolically. The area reserved by the BSS must be addressed 
relative to the symbol, GROPAY. 
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LAST SYMBOL IN BLOCK IN THE LOADER AREA 



LSBL 



Function 

LSBL reserves a block of consecutive memory locations and defines a 
Reference Symbol to the last of the reserved locations. Unlike LSB, ths 
block of reserved locations is not allocated "in line"; the block is re- 
served in the area occupied by the loader. Thus, I-SBL allows the 
programmer to make use of the entire computer memory for his appli- 
cations since it gives him the facility to overlay the loader. 

F ormat 

LSBL must contain 

• A symbol as the Reference Symbol 

• LSBL as the Operation 

• An expression in the Operation Parameters for the number of words 
to be reserved by the LSBL. 

A ssembler Action 

The expression in the Operation Parameters is evaluated to determine 
the number of words to be reserved. This value and the Reference 
Symbol are placed on the symbol table with a special flag. At the end 
of Pass I, the assembler punches this information so that the storage 
can be allocated when the program is loaded. When the loader reserves 
this memory, it does not clear the allocated area. Therefore, the 
programmer may not assume that the area reserved by an LSBL will 
initially contain zeroes. 
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1. All symbols used in the Operation Paxameters of LSBL must have 
been previously defined. (See Previously Defined Symbols, page 1-15. ) 

2. The result of evaluating the expression in the Operation Para- 
meters must be absolute (see Relocation Errors, page 1-35). 

3. LSBL should appear near the beginning of the program deck with 
the other pseudo- operations that allocate storSLge in the area 
occupied by the loader. When it is used in this way. the coding 
will contain centralized documentation that describes the over- 
lay of the loader. 



ACCUMULATOR REFERENCE POINT 



ARP 



In this example, if we assume that symbol A is assigned to location 
7500, symbol B will be assigned to location 7502 and symbol D will be 
assigned to location 7503. 

Symbolic reference IN will be punched in the binary deck with an 
indication that a block of 500 memory locations are to be reserved by 
the loader. The symbol IN will be assigned to the last location in this 
block. 

Symbolic reference OUT will be punched in the binary deck with an 
indication that a block of 100 memory locations are to be reserved by 
the loader. The symbol OUT will be assigned to the last location of 
this block. 

In this example, a block of 500 locations is reserved starting at sym- 
bolic location IN-499 and a block of 100 locations is reserved starting 
at symbolic location OUT-99. If there are other "loader area" pseudo- 
operations in the program, there is no guarantee that the two blocks of 
reserved locations will be next to each other in memory. Thus, the 
programmer may not assume that IN+100 is location OUT. 



Funition 

iVRP insures the programmer that those symbols which he uses as accumu- 
lator references are defined as locations which are evenly divisible by 
four. This need occurs because of the hardware requirement that the 
high order word of the quadruple accumulator be a memory location 
whi( h is evenly divisible by four. This concept is referred to as MOD 
4 and means that the number of the memory location must produce a 
s.ero remainder when divided by four. 

For:nat 

i\RT' must contain 

• A symbol or blanks as the Reference Symbol 

• ARP as the Operation 

• An expression in the Operation Parameters for the number of 
words to be reserved by the ARP. 

Assembler Action 



The ARP is executed in three steps; 

1. The assembler determines whether the current value of the 
location counter is evenly divisible by four. D; it is, the 
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assembler goes on to Step two. Otherwise, the assembler 
advances the location counter to the next location which is 
evenly divisible by four. In this process, from one to three 
locations may be "skipped over". These skipped locations are 
filled with Fill words which are generated by the assembler (see 
Fill on page 1-111. It is strongly recommended that the Fill 
instruction be used in conjunction with ARP to prevent errors 
which might occur if for any reason the program should branch 
to a skipped location). 

2. If there is a Reference Symbol, it is defined as the current 
value of the location counter as adjusted in Step one. 

3. The location counter is now increased by the value of the ex- 
pression in the Operation Parameters; thus, reserving a block 
of memory which is equal in length to the value of that expres- 
sion. ARP reserves memory; however, it does not clear the 
reserved area. Therefore, the programmer may not assume 
that an area reserved by an ARP will initially contain zeroes. 



Example 



K ! 



>^n.5 r,x,g. lA/ir, h. r-.; 

i.5. T Fi.7 A, J NU: H P. 






In this example the location counter is set to the next location which 
IS evenly divisible by four. The intervening words are Filled and two 
input areas, MASTERIN and DETAILIN, are reserved. The accumu- 
lator may now be located around various portions of the input records. 
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Notes 



1. All symbols used in the Operation Parameters of an ARP must 
have been previously defined (see Section Previously Defined 
Symbols, page 1-15). 

2. The result of evaluating the expression in the Operation Para- 
meters must be absolute (see Relocation Errors, page 1-35). 



ACCUMULATOR REFERENCE POINT IN THE LOADER AREA ARPL 



F unction 

ARPL reserves a block of consecutive memory locations starting at a 
Mod 4 address and defines a Reference Symbol as the first of the 
reserved locations. Unlike ARP, the block of reserved location, when 
usii-^ ARPL, is not allocated "in line". The block is reserved in the 
area occupied by the loader. Thus ARPL allows the programmer to 
make use of the entire computer memory for his applications since it 
gives him the facility to overlay the loader. 

Format 



ARPL must contain 

• A symbol as the Reference Symbol 

• ARPL as the Operation 

• An expression in the Operation Parameters for the number of 
words to be reserved by the ARPL. 

Assembler Action 



The expression in the Operation Parameters is evaluated to determine 
the number of words to be reserved. This value and the Reference 
Symbol are placed on the symbol table with a special flag. At the end 
of Pass I. the assembler punches this information so that storage can be 
allocated when the program is loaded. When the loader reserves this 
memory, it does so after stepping its data location counter to a Mod 
4 state. The procedure is similar to the assembler action on ARP with 
one exception: Fill words are not generated by the loader. When the 
loader reserves this memory, it does not clear the allocated area. 
Therefore, the programmer may not assume that the area reserved 
by ARPL will initially contain zeroes. 
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In this example, if we assume that symbol A is assigned to location 
7500, symbol B will be assigned to location 7502 and symbol D will be 
assigned to location 7503. 

Symbolic reference IN will be punched in the binary deck with an indica- 
tion that a block of 500 memory locations starting at a Mod 4 cell are 
to be reserved by the loader. The symbol N will be assigned to the 
first location (0 Mod 4) of this block. 

Symbolic reference OUT will be punched in the binary deck with an 
indication that a block of 100 memory locations starting at a Mod 4 
cell are to be reserved by the loader. The symbol OUT will be 
assigned to the first location (0 Mod 4) of this block. 

In this example, a block of 500 locations is reserved starting at sym- 
bolic location IN and a block of 100 locations is reserved starting at 
symbolic location OUT. Further, both locations IN and OUT are 
assigned to Mod 4 memory locations. If there are other "loader 
area" pseudo- operations in the program, there is no guarantee that 
the two blocks of reserved locations will be next to each other. Thus, 
the programmer may not assume that IN+500 is location OUT. 
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Notes 



1. All symbols used in the Operation Parameters of an ARPL must 
have been previously defined. (See Previously Defined Symbols, 
page 1-15). 

2. The result of evaluating the expression in the Operation Para- 
meters must be absolute {see Relocation Errors, page 1-35). 

3. ARPL should appear near the beginning of the program deck 
with the other pseudo- operations! that allocate storage in the 
area occupied by the loader. When it is used in this way, the 
coding will contain centralized documentation that describes 
the overlay of the loader. 



ACCUMULATOR 



ACUM 



Function 

The ACUM pseudo- operation allows the program to establish a working 
accumulator of 1, 2, 3, or 4 words and to define a symbol representing 
the location of that accumulator. Further, it assures, through the 
generation of Fill words (see FILL, page 1-1 11) that the area reserved 
for that accumulator will be properly positioned in memory. 

Note 

Since the most significant word of the quadruple accumulator must al- 
ways be in a location which is evenly divisible by 4, it follows that: 

• The most significant word of the triple accumulator must always 
be in a location which, when divided by 4. produces a remainder 
of 1. 

• The most significant word of the double accumulator must always 
be in a location which, when divided by 4, produces a remainder 
of 2. 
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• The most significant word of the single accumulator must always 
be in a location which, when divided by 4, produces a remainder 
of 3. 

Format 

ACUM must contain 

• A symbol as the Reference Symbol 

• ACUM as the Operation 

• In the Operation Parameters, an expression for the size of the 
accumulator. 

As sembler Action 

The assembler evaluates the expression in the Operation Parameters, 
and, based on the value of that expression, adjusts the location counter 
to the proper setting; producing a Fill word for each location skipped 
while adjusting the location counter. The Reference Symbol is then 
defined as the current value of the location counter and the value of 
the expression is added to the location counter; thus, reserving space 
for the specified accumulator. 

Note 

The expression for the accumulator size may be zero, one, two, three^ 
or four. K the expression is zero, the ACUM will be treated as an 
ARPO . If it exceeds four, it will be flawed and treated as an 
ACUM 4. ACUM reserves memory; however, it does not clear the 
reserved area. Therefore, the programmer may not assume that an 
area reserved by an ACUM will initially contain zeroes. 
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Examples 

The programmer requires a single accumulator. 

1. 



REFERENCE SYMBOL OPERATION 
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OPERATION PARAMETEFIS 


DATA NAME 
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Assume that the current value of the location counter is 1010; then the 
ARP 3 Fills locations 1010-1011 and sets the location counter to 1015. 
The BSS 1 defines ACCUMl as 1015 and reserves memory for th«i single 
accumulator. Five locations, 1010-1014 are wasted. 

2. 
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Assume the location counter is positioned at 1010; then, the ACUM A 
Fills location 1010 and advances the location counter to 1011. ACCUM:. 
is defined as 1011, a single accumulator, and memory is reserved for 
a single accumulator. Only one location, 1010 is wasted. 

3. 
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Example three sets the location to the next location which is evenly 
clivisible by four, Fills the intervening locations, and forms a four-word 
constant FICA. Later instructions locate the accumulator at FICA 
and determine if GROPAY exceeds 480000. 



Notes 



All symbols used in the Operation Parameters of an ACUM 
must have been previously defined (see Previously Defined 
Symbols, page 1-15). 

The result of evaluating the expression in the Operation 
Parameters must be absolute (see Relocation Errors 
page 1-35). 



FILL WORD 



FILL 



J^unction 

FILL allows the programmer to specify the contents of Fill words 
produced by the assembler during the processing of an ARP or an 
ACUM. 

Format 



FILL must contain 

• A mnemonic machine operation code as -the Reference Symbol 

• FILL as the Operation 

• An expression in the Operation Parameters for the address 

• An expression in the Operation Parameters for the address of 
the Fill word. 



A ssembler Action 

The basic assembly language maintains a simulated line of coding 
with which it fills location skipped during the processing of an ARP 
or ACUM. Initially, this line is set to HLT O. 



1-111 



12/6/63 



When a Fill word is required, the assembler supplies this line of coding. 
FILL instructs the assembler to reconstruct the simulated line of coding. 
The mnemonic operation code from the Reference Symbol of the FILL be- 
comes the Operation of the simulated line of coding; the Operation Para- 
meters from the FILL complete the simulated line of coding. Any Fill 
words produced by the assembler, prior to another FILL, will contain 
the command specified in the FILL. 

Examples 



REFERENCE SYMBOL 


OPERA TION 


OPERATION PARAMETERS 


_ DATANAME 

fl^ 16 
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In example one, the Fill line is set to PXB DUMP, 6 to b<; used if loca- 
tions are skipped during execution of the ARP, Assume that the location 
counter for LDS is 1000. The coding above would result in the assembler 
assigning the following location values: 



1000 


LDS 


A 


1001 


ADS 
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1002 


PXB 


DUMP, 6 


1003 


PXB 


DUMP, 6 


1004 


ARP 


1000 



2, 
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Example two sets the Fill line to a PXB MONITOR, 6 and uses the PXB 
as Fill if locations are skipped during execution of the ACUM. 
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CONSTANT PRODUCING PSEUDO OPERATIONS 

Often in writing a program, the programmer will find that some of the 
items with which he is working remain static during the duration of his 
program. Such items are called constants, and they occur in nearly 
all programs. 

A constant may be classified in terms of its composition as numeric, 
alphabetic, or alphanumeric. 

A numeric constant is composed of some combination of the numerals 
zero to nine and may contain a leading plus sign or minus sign. An 
alphabetic constant is composed of some combination of the 26 alpha- 
betic characters; it has no sign. An alphanumeric constant may contain 
numeric, alphabetic, or special machine characters; it has no sign. 

In terms of its use, a constant may be classified as either numeric or 
alphanumeric. A constant is numeric when it is used computationally, 
that is, when it is involved in an arithmetic or logical operation. If ;: 
constant is not used computationally, it is considered to be alphanumeric 

For example, the programmer is producing a printed report, each page 
of which will contain a page number and a date. The page number will 
change with each page; however, the remaining data is constant: 



P AGEING. AXXXX 



DATE 011563 



To take care of the requirements, the programmer creates four 
constants: 

1. PAGEANO 

2. DATE 

3. 011563 

4. 1 

In terms of composition, the first constant is alphanumeric - letters and 
symbols. The second constant is alphabetic - all letters. The third 
and fourth are numeric. 

In terms of their use, constants one. two and three are alphanumeric - 
not computational. Constant four is numeric; it is used to update the 
page count and is, therefore, computational. 
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The pseudo- operations which are described on the following pageis may 
be used by the programmer to generate the constants required in his 
program. They may also be used to set areas reserved for variEible data 
to an initial state. 



DECS-DECD-DECT-DECQ 



DECIMAL CONSTANTS 



F unction 

These four mnemonics represent 

DECS Decimal Sir^le 

DECD Decimal Double 

DECT Decimal Triple 

DECQ Decimal Quadruple 

These four pseudo- operations are used to create decimal constants of 
one, two, three or four words respectively. 

Format 



A decimal constant contains 

• A symbol or blanks as the Reference Symbol. 

• DECS, DECD, DECT, or DECQ as the Operation. 

• In the Operation Parameters, a decimal number, with or without 
a leading sign, as the constant. 

The limitation on the number of digits which may appear in a decimal 
constant is as follows: 

DECS One to four digits 

DECD One to eight digits 

DECT One to twelve digits 

DECQ One to sixteen digits 

A ssembler Action 

The specified constant is right -justified and assembled into one, two, 
three or four computer words depending upon the mnemonic operation 
code. If it is preceded by a minus sign, the constant is assembled as 
a negative quantity. If there is a leading plus sign or if there is no sig;i, 
the constant is assembled as a positive quantity. 
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If there is a Reference Symbol, it is defined as the location of the 
word containing the least significant digit of the decimal constant. 
Decimal points may not appear in constants' generated by Decimal 
Instructions. 



Example 

Assume that the current value of the location coimter is 1000. 
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This coding produces the following results 
Decimal Location Content 



1000 


2000 


Kl is defined as 1000 


1001 


0001 


K2 is defined as 1001 


1002 


1234 




1003 


5678 


K3 is defined as 1003 


1004 


0000 




1005 


0012 


K4 is defined as 1005 


1006 


1234 




1007 


5678 




1008 


9012 


K5 is defined as 1008 


1009 


0000 




1010 


0000 




1011 


0123 


K6 is defined as 1011 


1012 


1234 




1013 


5678 




1014 


9012 




1015 


3456 


K7 is defined as 1015 


1016 


0000 




1017 


0000 




1018 


0000 




1019 


1234 


K8 is defined as 1019 



ALPHANUMERIC CONSTANT 



AN 
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F unction 

AN enables the programmer to form alphanumeric constants within his 
program. 

Format 



An alphanumeric constant may contain 

• A symbol or blanks as the Reference Symbol 

• AN as the Operation 

• A word count (1-13) in the second half of the Oj)eration 

• The characters of the alphanumeric constant in the Operation Para- 
meters. 
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Assembly Action 

If there is a Reference Symbol, it is defined as the current value of the 
location counter, i. e. , as the first word of the constant which is formed. 
The assembler forms the number of words indicated in the second half 
of the Operation. Each word contains four of the specified characters; 
the first word contains the first four characters, the second word the next 
four characters, etc. Since the Operation Parameters contains a max- 
imum of 52 columns (25-76), the maximum word count permissible in 
an AN is 13 (52-^4). An alpha-numeric constant produced by AN may con- 
tain any combination of valid machine characters including commas and 
blanks. Commas may immediately follow the last character of the con- 
stant in the Operation Parameters. 

Examples 

Assume that the location counter is 1000 



1. 



•aCR SSMBOL 



(n.-5_,0,i 



Off- RATION 



A fVi . 



^ARAMUT FRS 



I C T U H E 



Axl^G-j jv^uAi£., V ira,RtXL^i R . O i V ijft 



In example one, MSGl will be assigned to 1000 and form four words (1000- 
1003) containing 16 characters from the Operation Parameters. 



REFERENCE SYMBOL 


OPERATION 
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OPERATION PARAMETCBB 


DATA NAME 

9 16 


LEVEL 
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1 3 



























In example four 13 words of blanks will be formed . 



LAST SYMBOL ALPHANUMERIC 



]LSAN 



Function 

LSAN enables the programmer to enter alphanumeric constants into his 
program. It is identical in use to the AN pseudo-operation w*ich was 
just described, with the exception that the Reference Symbol is assigned 
to the last word produced by the assembler. 

Format 



LSAN may contain 

• A symbol or blanks as the Reference Symbols 

• LSAN as'the Operation 

• A word count (1-13) in the second half of the Operation 

• The characters of the alphanumeric constant in the Operation IPara- 
meters. 



In example two, MSG2 will be assigned to 1004 and form two words (1004- 
1005) containing eight characters from the Operation Parameters. 




— IClj- 



"l.^.t.3-. 



In example three, MSG3 will be assigned to 1006 and form two words 
(1006-1007) containing eight characters from the Operation Parameters. 



Assembler Action 

K there is a Reference Symbol.it is assigned to the last word of a multi- 
word constant which is formed by the assembler. The assembler con- 
structs the number of words indicated in the second half of the opei-ation. 
Each word will contain four characters. The first word is taken from 
columns 25-28 of the Operation Parameters; each suceeding word is con- 
stracted from the succeeding four columns of the Operation Parameters. 
An LSAN Operation allows for a maximum of 13 words to be entered in 
the 52 columns (25-76). Any combination of valid symbols may be used 
in the Operation Parameters. 
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Examples 

Assume that the location counter is at 1000. 



1. 



REFERENCE SYMBOL 



DATA NAME 



M^^ 



OP FRA TION 



U^-L^JVi 



OPERATION PARAh 



PIC T U R E 



SS.f .€ .R.ft.T.j?f.R.A.f.a,fl,p.,p, , 



In example one.MSGl will be assigned to 1004 and form five words taken 
from the Operation Parameters. The last word will contain blanks since 
there are only 14 characters specified. 



PaS_L£^_l._^ 



' 'M'' ' ^I4 ' 'I I I |P ' ^ ' ff ''S:-^::^^g^^ 



^a!^""!^ ^^°' ^^'^^ "^^ ^^ assigned 1006 and the six characters in 
fn^c ~ * *^",''^.fo""'^ i" the six high order position of location 1005 and 
1006 with two trailing blanks. , 



3.. 



-J 1 1 1— 



I ,l.3,^,■?, k•^.^.<) .<^ 



In example three MSG3 will be assigned to 1009 and the numbers 1—0 
will appear in the high order ten characters position of words 1007-1009. 



4. 



g.L.ft .N/.K,-:.! , 



US^Alh. 



In example four, blanks will be assigned to location 1013 and four words 
of blanks will be placed in words 1010-1013. 
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OCTAL CONSTANTS 



Fu iction 



OCTS-OCTD-OCTT-OCTQ 



Thijse four mnemonics represent 

OCTS Octal Single 

OCTD Octal Double 

OCTT Octal Triple 

OCTQ Octal Quadruple 

These four pseudo- operations are used to create octal constants of one 
two. three, or four words respectively. 

Foi mat 



An jctal constant may contain 

• A symbol or blanks as the Reference Symbol 

• OCTS, OCTD, OCTT, or OCTQ as the Operation 

• An unsigned octal number as the constant in the Operation Parameters. 

The limitation on the number of digits which may appear in an octal 
constant is as follows: 



OCTS 
OCTD 
OCTT 
OCTQ 
Ass embly Action 



One to eight octal digits 
One to sixteen octal digits 
One to twenty-four octal digits 
One to thirty- two octal digits 



The specified constant is right justified and assembled into one two 
7" ^T/r"" '=°'"P"'^^ ^°^ds depending upon the mnemonic operation 
ode. If there is a Reference Symbol, it is defined as the location of 
tJie word containmg the least significant digit of the octal constant 
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Example 

Assume that the current value of the location counter is 2000. 



ASSEMBLY OUTPUT CONTROL PSEUDO-OPERATIONS 



REFERENCE 5YM80L 



□AT* NAME 



^K^Ja_. 


a:, K, ki..^^ 


^lK.2ll- L 


jSTo^K.. H...__. 


^>J<_5.. -, 


0K.b. . 


K,K 7, , 


SI.K.&, . 



OPERATIO^ 



a. 

i 





C TjJl . 
C T.9 



-, 4- 



JARAMFTPHS 






I .7, I ,T . 1,7 , 1 ,7, 1 ,7i I . 7 



-|_L,: ^ . ,3 , s , 

7.7,7,7 ,^.^ <i> ,_fc^.5,5,S. 



J.L_L,X 






This coding produces the following results: 
Decimal Location Content 



2000 


17777777 


OKI is defined as 2000 


2001 


00000012 


OK2 is defined as 2001 


2002 


17171717 




2003 


17171717 


OK3 is defined as 2003 


2004 


00000000 




2005 


00001234 


OK4 is defined as 2005 


2006 


00000000 




2007 


00007777 




2008 


66665555 


0K5 is defined as 2008 


2009 


00000000 




2010 


00000000 




2011 


00123456 


OK6 is defined as 2011 


2012 


00000000 




2013 


00000000 




2014 


00776655 




2015 


44332211 


OK7 is defined as 2015 


2016 


00000000 




2017 


00000000 




2018 


00000000 




2019 


12345670 


OK8 is defined as 2019 



TITLE 



TTL 



Function 

TTL allows the programmer to specify the heading line printed at th(; 
top of each page of the assembly llstir^. 



Format 

TTL must contain 

• TTL as the Operation 

• A page heading in columns 25-76 of the coding form. 



Assembler Action 

When the assembler encounters a TTL in Pass II, it prints the card 
containing the TTL, slews the assembly listing to the top of page; ami 
prints columns 25-76 of the TTL as the page heading. This same 
heading will be printed on all subsequent pages of the listing until a 
new TTL is received. Prior to encountering a TTL, the assembler 
will supply the heading line. 

Example 



OPERA 


TION 


OPERATION PARAMETERS 
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1" 19 
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I,L,C, 


U,P,D,fl,T,f. 
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EJECT PAGE 



EJT 



Function 

EJT causes the assembler to slew the assembly listing to the top of the 
page before reading the next instruction. 



Format 

EJT contains EJT as the Operation. 



Assembler Action 

When the assembler encounters an EJT in Pass II, it prints the card 
containing the EJT and slews the assembly listing to the top of the 
page. 

Example 





HKFERENCE SYMBOL 


OPERA 


TION 




OPERATION 


P AR A» 


flETERS 




D AT A N AME 

• 


ie 


\7 


LEVEL 
IS 19 


20 


5 

C 


22 


E 


24 


28 


PIC 


T U R E 






1 1 1 1 1 1 1 


f 


J"iT 





































1 ■ 


1 1 
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IDENTIFY BINARY OUTPUT 



IDEN 



li '\mction 

IDEN allows the programmer to specify ihe identification, in columns 
'i7-80, for his binary cards. 



Format 

IDEN must contain 

« IDEN as the Operation 

• Four identification characters in columns 25-28. 



Assembler Action 

When the^ssembler encounters an IDEN,, it causes the characters 
contained in columns 25-28 from the IDEN to be pimched in all binary 
output cards. Any four characters selected by the programmer may be 
used as identification. If the source program does not contain an IDEN, 
the identification field in the binary output cards is blank. 



l ibcample 



REFERENCE SYMBOL 




OPERATION 

( 






OPERATION PARAMETERS 


DATA NAME 
ie 


17 


'irfi 


20 


\ 


22 


4, 

E 


24 


PICTURE 
2B 




T 


Dif 


/V 










e.L.e-I), 







































Restriction 

The source program may not contain more than one IDEN. 
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FULL BINARY CARDS 



FULL 



Function 

The normal binary output card contains such data as card type, word 
count, checksum, instruction flags, instructions, aiid identification. 
Occasionally, as in the case of a memory load program, it may be 
necessary to produce output cards which contain only instructions. 
FULL controls the format of the binary output card, by instructing 
the assembler to produce its output in the full card format - 40 
instructions per card. 



Format 



FULL contains FULL in the Operation. 



Assembler Action 



When the assembler encounters a FULL it produces the binary pro- 
gram in the full card format. 

Example 



REFERENCE 5VMB0L 


O P t: R A 


TION 


JPEflATION PARAMETERS 


DATA NAME 
9 IB 


17 


1? 19] iO 


5 
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24 


PICTURE 
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1 1 I 1 1 , 1 1 1 1 t • 
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SYMBOLIC ANALYZER 



SYAL 



Function 

SYAL instructs the assembler to produce a symbolic analyzer ta|)e 
during Pass n and to engage the Symbolic Analyzer Program upon 
termination of Pass U. 



Format 



SYAL contains SYAL as the Operation. 



Assembler Action 



When the assembler recognizes the SYAL in Pass I, it signals Pass n 
to produce the symbolic analyzer tape and to engage the Symbolic 
Analyzer upon termination of Pass U. The symbolic analyzer portion 
of the assembler is optional but it is highly recommended. Its use 
requires an additional tape imit. 



Example 



REFERENCE SYMBOL 


OPERATION 
1 




OPERA TION PARAMETEi^S 


DATA NAME 
9 16 


17 


LEVEL 
18 t9 


20 


S 

c 


22 


E 


24 


2B 


PICTURE 




5 


Yifl 


I 










1 1 • 1 1 If ' 


1 1 1 




1 












1 . . [ 1 . 1 1 • 1 1 1 1 
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MISCELLANEOUS PSEUDO- OPERATIONS 



ORIGIN 



ORG 



Function 

ORG sets the location counter to a specific value during the assembly 
of a program. 



Format 



ORG may contain 

• A symbol or blanks as the Reference Symbol 

• ORG as the Operation 

• An expression in the Operation Parameters to indicate the value 
at which the location counter is to be set. 



Assembler Action 

If there is a Reference Symbol, it is defined as the value of the expres- 
sion in the Operation Parameters, Since ORG sets the location counter 
to a specified value, it causes the next assembled instruction to be as- 
signed to the location represented by that value. The process is com- 
pleted in Pass II where the assembler informs the loader of the fact 
that a change in the location counter has occurred. This is accomplished 
by means of flags on the binary output. 

Examples 



1. 



REFERENCE SYMBOL 


OPERA 


T10N 


OPERATION PARAMETERS 


. ^---'--^ ,. 


17 


LEVEL 

IP 19 


.0 


S 


22 




24 


PICTURE 

2B 


R,fl,T,,£, , , , 


^sR^Gl 












1,6.0.0, ■ . , 




Bi5 ,5 












1,0 


1 1 1 1 . . 1 

















1-12? 



12/6/63 



The ORG sets the location counter to 1000 decimal and defines RATE as 
1000. The BSS reserves 10 locations (1000-1009), 



2, 



R EPERENCE SYMBOL 


OPERATION 

1 


OPERATrON PARAMETERS 


DATA name: 

» 18 


17 


LEVEL 

le IB 


20 


9 

\ 

C 


22 


Hi 

E 


24 


2B 




PICTURE 


1 1 1 1 1 L. ., 1 




1 " 














1 1 1 1 > 





Rifi 












). 1 


A 


t\ 


T, (,M, f. , . . 


f? 


fiuS 












li 0, 






















1 1 1 1 1_ 



The ORG sets the location counter to 1100 decimal. The BSS reserves 
10 locations (1100-1109) and defines TIME as 1100. 

3. 



M.g.lJ.R s. 



i»;ft.& i 



a I S .s 



R, ft. T. £.-»■. 1 a. 



3_xiL_ 



The ORG sets the location counter to RATE+10 (1010 decimal). The 
BSS reserves 90 locations (1010-1099) and defines HOURS as 1010. 



J 1 i L_ 




-I L 1 1_ 



tLRJkl 



I iDi^i 



x.o,o, 



S-i ft i T , L, 



The ORG sets the location counter to 200 decimal ana defines START as 
200. The LDS 1000 is assigned to location 200 and BEGIN is defined as 
200. 

Notes 



1. All symbols appearing in the Operation Parairieters of an ORG must 
have been previously defined (see Previously iDefined Symbols, 
page 1-15). 

2, The expression in the Operation Parameters may not contain an 
external global symbol (see Local and Global !3ymbols, page 1-31). 
This function is accomplished by means of the SGMT pseudo- 
operation (see description of SGMT, pjtge 1-35). 
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OraOIN OCTAL 



ORGO 



Fimction 

ORGO sets the location counter to a specific octal value during the 
assembly of a program. 



Format 

ORGO must contain 

• A symbol or blanks as the Reference Symbol 

• ORGO as the Operation 

• An imsigned octal number in the Operation Parameters as the 
setting of the location counter. 



Assembler Action 

The ORGO performs the same function as the ORG, however, the 
setting of the location counter must be expressed as an octal number 
in the Operation. 



Example 




X.^/jRlL. 



— L — , — 1.„.,. ._,j — J- .1 ; — 1. -4 — j-^-j.-. 

---^-'— '--'-- - ^-'-+-^ — ^ ■--4-1- 



The ORGO sets the locatior-. counier to 200 octal 120: deciriKu ' id 
defines INREC as 128 decirnai, 
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EQUALS 



EQU 



Function 

EQU instructs the assembler to define the symbol which appears in 
the Reference Symbol as the value specified in the Operations Para- 
meters. 



Format 

EQU must contain 

• A symbol as the Reference Symbol 

• EQU as the Operation 

• An expression in the Operation Parameters for the value of the 
Reference Symbol. 



Assembler Action 

I'he assembler defines the Reference Symbol as the value of the e;«pres- 
sion in the Operation Parameters. K the expression is an asterisk, 
tiie Reference Symbol is defined as the current value of the location 
coimter. 



E xamples 



1 ReFEPE^ 

if 


c e: s vm bc 


L OPERA 


TION 




i: c A 




10 


... 


?o 


Cl 2.7. 




lFaAxi'_L 


>Ji _u_ 




faQiU 


._. 


.. -4 , 




y^s 










3 



11 example 1, the EQU defines PAYCE as tsie t-u: rent value cs ;■• 
location counter 1000. 
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REFERENCE SYMBOL 


OPERA 


TION 

1 


OPERATION PARAMETERS 


DATA NAME 


17 


LEVEL 
IB IS 


20 


\ 


22 


E 


24 


PICTURE 
2B 






, 















T.I ,tA.C -D- . 


P 


QU 










P.n.y.cix ....... 


















1 



In example 2, the EQU defines TIMCD as the symbolic value PAYCD 
(1000). 



— 1 — t 1 — 1 — 1 — 1 — 1 — 

F.\C.H. , 


f 


Qili 


— 








>. n. a ...... . ^^ 


















1 1 1 1 1 1 . ..) 




, 













In exan4)le 3, the EQU defines FICA as 200. 
Notes 

1. All symbols appearing in the Operation Parameters of an EQU 
must have been previously defined, (see Previously Defined 
Symbols, page 1-15). 

2. The expression in the Operation Parameters may not contain an 
external global symbol (see Local and Global Symbols, page 1-31). 
This function is accomplished by means of the EQUG pseudo- 
operation (see page 1-85). 
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EQUALS OCTAL 



EQUO 



Function 

EQUO instructs the assembler to define the symbol wliich appears in 
the Reference Symbol as the octal number specified in the Operation 
Parameters, 



Format 

EQUO must contain 

• A symbol as the Reference Symbol 

• EQUO as the Operation 

• An unsigned octal number in the Operation Piirameters as the 
value of the Reference Symbol. 



Assembler Action 

EQUO performs the same function as EQU. 

Example 



REFERENCE SYMBOL 


OPERATION 

1 


OPERATION PARAMETERS 


DATA NAME 
8 16 


17 


le:,veL( 


20 


C 


.. 


S 

E 


24 


PICTURE 


A,Gu&j .L. ... , , 


f. 


Q.An 


»( 










1,0,1 


■ •■111 




' 












1 
























-- 










The EQUO defines AGE as 101 octal (65 decimal). 
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PREFIX 



PRFX 



A programmer may decide to further subdivide his segments into 
smaller regions, to code each of the regions as an entry, and to com- 
bine the regions as a single source segment for assembly. 

Since each of the regions is written separately, there is a possibility 
that similar symbols exist in two or more of the regions. If similar 
symbols do exist, multiple defined errors will occur during the assembly. 
PRFX minimizes this problem by allowing the programmer to specify 
a unique prefix character for each of his regions. 



Format 

PRFX must contain 

• A single alphanumeric or numeric prefix character in card column 
nine, the first column of the Reference Symbol. 

• PRFX as the Operation. 



Assembler Actio n 

When the assembler encounters a PRFX, it saves the prefix character. 
During assembly, the symbols which appear in subsequent instructions 
in either the Reference Symbol or the Operation Parameters are pre- 
fixed with that prefix character. The assembler stops prefixing 
instructions when it encounters a new PRFX. Subsequent instructions 
are prefixed with the new prefix character. This procedure minimizes 
the possibility of multi-defined symbols between regions. 

The assembler right justifies all symbols and replaces leading blanks 
with zeroes. Thus, the symbol PAY becomes OOOOOPAY. When the 
assembler encounters a symbol in a prefixed region, it examines the 
high order character of that symbol. If the character is a zero, the 
assembler replaces it with the prefix character. Thus, in a region 
prefixed by X, PAY becomes XOOOOPAY. 
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Note : 

Eight character symbols are not prefixed and a region prefixed iDy a 

zero is equivalent to an unprefixed region. 



Communication Between Regions 

Althoi^h the regions of a segment are treated as distinct Imits by the 
programmer, there will be times when communication between thein is 
required; one may contain data, constants or subroutines used by 
another. Since eight character symbols are not prefixed, they may be 
used whenever communication is necessary. If the programmer does 
not desire to use eight character symbols, he may employ the $ 
character to facilitate communication. 

When using the $ method, the programmer should append the proper 
prefix character and the $ to the high order side of the symbol before 
placing it in the Operation Parameters of his instruction. The symbol 
will then be assembled using the character which precedes the $ as 
the prefix character for that symbol. 

Examples 



1, 



r-'f:'=E"F:..' S-. 


MBO l_ 


°-ER. 


T,ON 




OPERATK^N PARAM 


li T E R S 


CA T A N A 
9 




L .T V t L, 
1 -^ ■ 1 •> 


jO 


5 


zz 


e: 


24 


25 


PIC TURF 




Qj_ _L ^__J_ _U 


— -I 1, _ _ 


P^R,F.^ 


X, 










, 






f.,/V\^v^ <N.fl, 


S:S_,& 














W_lAJ\\_Ll__. 


-.. , BiS.Sj 


, . 




__. 


_ 


1 . 0, . 1 1 1 1 , . . 1 , 



Example 1 shows a region prefixed by a zero, an impref txed o-egi.on. 
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2. 


REFERENCE S-ZMBOL 


OPERATION 
I 


OPERATION PARAMETERS 




DATA NAME 
9 16 


17 


LEVEL 
IB 19 


20 


\ 


22 


E 


34 


PICTURE 
2G 




X. , , ... . . - 




)^ 










^ ^ 1 ^ , 














i.P ,M,P ,iv.«, m. ,<i>,^,£,N\,P,fV,«r, 


-4 




r z.r .9 A,Y. 


L S B 


^ 






?,$, R,'\rr'E-, ■ ■ 




.___,.._ _^„._ 


if . 1 


" 


IL S .B ^ -_ . 

li. t CD _: .. 


H, 






H R ,0 fi O.'^, ■ . , , , ■ ' 


, 




R, AT, f.. , , , I 










, . , 1 . , 1 , 














-^--- •- • - 


Loi) i - t;- 


£.M,PN,f^i , , ■ 


- 


t - - -' 







TRANSFER CONTROL CARD 



TCD 



Example 2 shows 
eating with other 



a region prefixed bjf X and a method of communi- 
regions using the EQU. 



Function 

TCD indicates that an interruption in the loading process is desired so 
that the programmer may execute some instructions in his program and 
then return control to the loader. 

Two functions are performed by TCD. 

1 . ' It terminates the assembly of this segment. 

2. It prepares the loader transfer card (TCD- Type 6()). 



.&fi..2LP.&.V 

RATi. 

£ T Ft R T.. , 



^ 



£ q.u_4.. 

|L s e 

jL D D 
■ADD 
S T D 

:ld d 



■$, F -,rAiPiN ,a'*^ 






X 4 i & i R ,^i/e-AJ£ 




3^.fi.T-£. ^ 



Example 3 shows 
eating with other 

4. 



a region prefixed by a Z and a method for commvini- 
regions using the EQU. 



[P R F JL 
it- D i) 
'A B D _ 

-^L.Dli _ 






ix i -&.R jef p^-Y-w ^ . 



Example 4 shows a region prefixed by Y and a method for communi- 
cating with other regions without using the EQU. 
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Format 

TCD must contain 

• TCD as the Operation 

• An expression in the Operation Parameters for the address to 
which control will be transferred during loading. 



Assembler Action 

When the assembler encounters a TCD it completes the processing and 
punching of all previous instructions and punches a transfer card to the 
address indicated in the Operation Pararaeters. 

Example 



ST ft R,T 



(LPS 



, J — J-, 



GLR,^P.A,y 



i -L 
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Note 

Control must be returned to the loader by the object program. This is 

accomplished by an unconditional branch to zero on index register 6 

(BRU0,6). 



Restriction 

The expression in the Operation Parameters may contain one external 
global symbol. In addition to the restrictions placed on external 
global symbols in DXG page 1-79, the external global must be either 
preceded by a plus sign or the plus sign must be implied. 

Care must be exercised if this external global symbol feature is used. 
When the object program receives control, the programmer must be 
sure that all necessary subroutines are in memory and that all required 
external global symbols have been defined. 



END OF PROGRAM 



END 



Function 

The END pseudo-operation terminates the assembly of this segment and 
prepares an END transfer card for the loader (card type 70). 



Format 

END may contain 

• END as the Operation 

• An expression or blanks in the Operation Parameters. 



Assem bler Actio n 

When the END is encountered in Pass 11, the Operation Parameters is 
scanned. If the field is blank, no transfer control card is produced. If 
the field contsiins an expression, the expression is evaluated and the 
resulting address is placed in the transfer control card. 
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Examples 
1. 





REFERENCE SYMBOL 


OPCRATION 

r 


OPERATroN PARAMETERS 




DATA NAME 
9 16 


17 


LEVEL 
18 19 


20 


C 


22 


E 


24 


p r c r u R E 

ZB 




N\.ft. 1 iN.P.R.^jC.G 


L 


Di8 












G,R.(2^.p,fl,y 


































































£. 


w,0 












M.ft ,r ,K,P .({ ai.C, 





















Example 1 indicates the assembly of a main segment. A transfer of 
control to symbolic location MAINPROG is effected at the end of the 
loading process. 



, 



















5.1, ft .ft..T,£ ,f i^i 


1 


n,-^ 










p.ft.Y '■ 






















< 1 


















( 1 














.... ■± :. .1. ... . i. 


£L 


N.n 




— 






— 


.-> ' ' 1 



Example 2 indicates the assembly of a subsegment. There will be no 
address in the transfer control card produced. 



Note 

When an expression is present in the Operation Parameters, it may 

contain one external global symbol. In addition to the restrictions 

placed on external global symbols on page 1-79 , the external global 

must be either preceded by a plus sign or the plus sign must be 

implied. 
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TABLES 



A.ALPHABETIC LISTING - COMPUTER INSTRUCTION REPERTOIRE 



Mnemonic Code 



ABA 


(2A) 


ABM 


(2A) 


ABX 


(2A) 


ADD 




ADQ 




ADS 




ADT 




AIM 


(2A) 


AIX 


(2A) 


AMD 




AMQ 




AMS 




AMT 




ANM 


(2A) 


ANX 


(2A) 


BCTR 




BRC 


(2A) 


BRE 




BRG 




BRL 




BRM 





Computer Operation 

Accept Buffer Address 
Add Binary to Memory 
Add Binary to Index 
Add Decimal Double 
Add Decimal Quadruple 
Add Decimal Single 
Add Decimal Triple 
Add Immediate to Memory 
Add Immediate to Index 
Add to Memory Double 
Add to Memory Quadruple 
Add to Memory Single 
Add to Memory Triple 
AND to Memory 
AND to Index 

Branch Counter 
Branch on Count 
Branch if Equal 
Branch if Greater 
Branch if Less 
Branch if Minus 



Octal 

32 
34 
34 
51 
53 
50 
52 
33 
33 
55 
57 
54 
56 
24 
24 



16 
13 
12 
14 
11 



* 2A in this column indicates a two-address instruction. 

X An X following an Octal Code indicates that the octal value is a com- 
mand code, , not an operation code. 
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Mnemonic Code 



BRU 




BRZ 




BSF 


{2A) 


BSR 


(2A) 


BXC 


(2A) 



Computer O p eration 

Branch Unconditionally 
Branch if Zero 
Backspace one File 
Backspace one Record 
Branch on Index Count 



Octal 

10 
15 

47 X 
46 X 
16 



CAA 



CDA 



CMI 


(2A) 


CMM 


(2A) 


CPO 


(2A) 


CPR 


(2A) 


CXI 


(2A) 


CXM 


(2A) 


DCWC 





DC WW 



Compare Alphanumeric Accumulator 
to Memory 03 

Compare Decimal Accumulator to 

Memory 02 

Compare Memory to Immediate 01 

Compare Second to first Memory 04 

Central Processor Operation 67 

Compare 57 

Compare Index to Immediate 01 

Compare Index to Memory 04 

Data Control Word Character 
Count 

Data Control Word Word Count 



EDT 
ERS 
EXP 



(2A) 



Edit 

Erase 

Explode 



05 

54 X 
20 



=- 2A in this column indicates a two-address instruction. 

X An X fol]-,wing an Octal Code i.idicates that the octal value is a 
command code, not an operf on code. 
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Mnemonic Code 



FDOC (2A) 

FSF (2A) 

FSR (2A) 



Computer Operation 

Feed Document 
Forward Space one File 
Forward Space one Record 



Octal 



41 


X 


45 


X 


44 


X 



GEN 



(2A) 



General 



07 



HLT 



Halt 



00 



lAW 




Indirect Address Word 


00 


IMP 




Implode 


21 


LAL 




Load Accumulator Location and 








Length 


36 


LBFC 


(2A) 


Load Buffer for Compare 


36 X 


LBT 




Low Bit Test 


22 


LDD 




Load Double 


41 


LDQ 




Load Quadruple 


43 


LDS 




Load Single 


40 


LDT 




Load Triple 


42 


LDX 


(2A) 


Load Index 


30 


LNK 


(2A) 


Link 


75 X 


LPW 




List Pointer Word 




LXI 


(2A) 


Load Index with Immediate 


31 


MCTR 




Move Counter 




MFI 


(2A) 


Move From Immediate 


31 



* 2A in this column indicates a two-address instruction. 

X An X following an Octal Code indicates that the octal value is a 
command code, not an operation code. 
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Mnemonic Code 



Computer Operation 



Octal 



MFM 


(2A) 


Move from First Memory 


30 




MOV 


(2A) 


Move 


06 




MTA 


(2A) 


Move to first Address Field 


32 




MVDT 


(2A) 


Move Data 


37 


x 


MXC 


(2A) 


Move on Index Control 


06 




O 




Operand 


00 




OL 




Operand Link 


02 




OP 




Operand Pointer 


01 




PCB 


(2A) 


Punch Card Binary 


11 


X 


PCD 


(2A) 


Punch Card Decimal 


12 


X 


PCE 


(2A) 


Punch Card in Edited Mode 


13 


X 


PDOC 


(2A) 


Pocket Document 


43 


X 


PDT 


(2A) 


Punch Double character mode 










Tape 


13 


X 


PET 


(2A) 


Punch Edited Tape - system mode 


31 


X 


PPT 


(2A) 


Punch Paper Tape 


11 


X 


PRE 


(2A) 


Print in the Edit mode (data 










controls slewing) 


30 


X 


PRED 


(2A) 


Print in the Edit mode - slew 










Double line 


32 


X 


PRES 


(2A) 


Print in the Edit mode - slew 










Single line 


31 


X 


PRET 


(2A) 


Print in the Edit mode to Top 










of page 


33 


X 


PRN 


(2A) 


Print in the Non-edited mode - 










slew no lines 


10 


X 



* 2A in this column indicates a two-address instruction. 

X An X following an Octal Code indicates that the octal value in a 
command code, not an operation code. 
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Mnemonic Code 



PRND 


(2A) 


PR NT 


(2A) 


PRNS 


(2A) 


PST 


^2A) 


PXB 


(2A) 



Computer Operation Octal 

Print in the Non-edited mode - 

slew Double line 12 x 

Print in the Non-edited mode - 

slew to Top of page 13 x 

Print in the Non-edited mode - 

slew Single line 11 x 

Punch Single character mode Tape 16 x 

Program counter to Index and 

Branch 17 



RALD 




RALQ 




RALS 




RALT 




RB 


(2A) 


RGB 


(2A) 


RCD 


(2A) 


RCM 


(2A) 


RDOC 


(2A) 


RF 


(2A) 


RFCR 


(2A) 


RFI 


(2A) 


RFR 


(2A) 


RIM 


(2A) 


RIX 


(2A) 



Reset Accumulator Length Double 22 

Reset Accumulator Length 
Quadruple 



Reset Accumulator Length Single 

Reset Accumulator Length Triple 

Read Buffer 

Read Card Binary 

Read Card Decimal 

Read Card Mixed mode 

Read Document 

Read File 

Read File Continuous and 
Release Seek 

Read File and Increment Address 

Read File and Release seek 

OR Inclusive to Memory 

OR Inclusive to Index 



22 




22 




22 




24 


x 


01 


X 


02 


X 


03 


X 


01 


X 


54 


X 


25 


X 


56 


X 


55 


X 


23 




23 





* 2A in this column indicates a two-address instruction. 

X An X following an Octal Code indicates that the octal value is a 
command code, not an operation code. 
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Mnemonic Code 



Computer Operation 



Octal 



RLDA 




Rotate Left Double Alpha 


22 


RLDAS 




Rotate Left Double Alpha 
and Set 


22 


RLDD 




Rotate Left Double Decimal 


22 


RLDDS 




Rotate Left Double Decimal 
and Set 


22 


RLQA 




Rotate Left Quadruple Alpha 


22 


RLQAS 




Rotate Left Quadruple Alpha 
and Set 


22 


RLQD 




Rotate Left Quadruple Decimal 


22 


RLQDS 




Rotate Left Quadruple Decimal 
and Set 


22 


RLSA 




Rotate Left Single Alpha 


22 


RLSAS 




Rotate Left Single Alpha and Set 


22 


RLSD 




Rotate Left Single Decimal 


22 


RLSDS 




Rotate Left Single Decimal and Set 


22 


RLTA 




Rotate Left Triple Alpha 


22 


RLTAS 




Rotate Left Triple Alpha and Set 


22 


RLTD 




Rotate Left Triple Decimal 


22 


RLTDS 




Rotate Left Ti'iple Decimal and Set 


22 


RPT 


(2A) 


Read Paper Tape 


02 X 


RQSP 


(2A) 


Request Status of Processor 


67 


RQS 


(2A) 


Request Status 


00 X 


RQST 




Request Status of Typewriter 


00 


RRD 




Rotate Right Double (binary) 


22 


RRDA 




Rotate Right Double Alpha 


22 



An X following an Octal Code indicates that the octal value is a 
command code, not an operation code. 



1-144 



12/6/63 



Mnemonic Code 



Computer Operation 



Octal 



RRDAS 




Rotate Right Double Alpha and 
Set 


22 


RRDD 




Rotate Right 


Double Decimal 


22 


RRDDS 




Rotate Right 
Set 


Double Decimal and 


22 


RRDT 




Rotate Right Double (binary) Test 


22 


RRQA 




Rotate Right Quadruple Alpha 


22 


RRQAS 




Rotate Right Quadruple Alpha and 
Set 


22 


RRQD 




Rotate Right 


Quadruple Decimal 


22 


RRQDS 




Rotate Right Quadruple Decimal 
and Set 


22 


RRS 




Rotate Right 


Single (binary) 


22 


RRSA 




Rotate Right 


Single Alpha 


22 


RRS AS 




Rotate Right 


Single Alpha and Set 


22 


'^RSD 




Rotate Right 


Single Decimal 


22 


>RSDS 




Rotate Right 
Set 


Single Decimal and 


22 


RRST 




Rotate Right 


Single (binary) Test 


22 


RRTA 




Rotate Right 


Triple Alpha 


22 


RRTAS 




Rotate Right 


Triple Alpha and Set 


22 


RRTD 




Rotate Right 


Triple Decimal 


22 


RRTDS 




Rotate Right Triple Decimal and 
Set 


22 


RSS 


(2A) 


Reset Status 




40 X 


RSST 


(2A) 


Reset Status of Typewriter 


40 X 


RTB 


(2A) 


Read Tape Binary 


05 X 


RTD 


(2A) 


Read Tape Decimal 


04 X 



* 2A in this column indicates a two-address instruction. 

X An X following an Octal Code indicates that the octal value is a 
command code, not an operation code. 
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Mnemonic Code 



Computer Operation 



Octal 



RWD 


(2A) 


Rewind 


70 


X 


RWS 


(2A) 


Rewind and Standby 


72 


X 


RXM 


(2A) 


OR Exclusive to Memory 


25 




RXX 


(2A) 


OR Exclusive to Index 


25 





SAL 



SBM 


(2A) 


SBX 


(2A) 


SCPR 


(2A) 


SDD 




SDL 


(2A) 


SDH 


(2A) 


SDQ 




SDS 




SDT 




SF 


(2A) 


SLDA 




SLDAS 




SLDD 




SLDDS 




SLNK 


(2A) 


SLQA 




SLQAS 




SLQD 




SLQDS 





Store Accumulator Location and 

length 37 

Subtract Binary from Memory 35 

Subtract Binary from Index 35 

Seek/Compare 17 x 

Subtract Decimal Double 61 

Set Density Low 61 x 

Set Density High 60 x 

Subtract Decimal Quadruple 63 

Subtract Decimal Single 60 

Subtract Decimal Triple 62 

Seek File 34 x 

Shift Left Double Alpha 22 

Shift Left Double Alpha and Set 22 

Shift Left Double Decimal 22 

Shift Left Double Decimal and Set 22 

Seek/Link 35 x 

Shift Left Quadruple Alpha 22 

Shift Left Quadruple Alpha and Set 22 

Shift Left Quadruple Decimal 22 

Shift Left Quadruple Decimal 

and Set 22 



* 2A in this column indicates a two-address instruction. 

X An x following an Octal Code indicates that the octal value is a 
command code, not an operation code. 
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Mnemonic Code 



SLSA 




SLSAS 




SLSD 




SLSDS 




SLTA 




SLTAS 




SLTD 




SLTDS 




SPB 


(2A) 


SPRD 


(2A) 


SPRS 


(2A) 


SPRT 


(2A) 


SRD 




SRDA 




SRDAS 




SRDDS 




SRDT 




SRF 


(2A) 


SRFI 


(2A) 


SRFR 


(2A) 


SRQA 




SRQAS 





Computer Operation 



Octal 



SRQD 



Shift Left Single Alpha 


22 


Shift Left Single Alpha and Set 


22 


Shift Left Single Decimal 


22 


Shift Left Single Decimal and Set 


22 


Shift Left Triple Alpha 


22 


Shift Left Triple Alpha and Set 


22 


Shift Left Triple Decimal 


22 


Shift Left Triple Decimal and Set 


22 


Store Program counter and Branch 


17 


Slew Printer Double line 


62 X 


Slew Printer Single line 


61 X 


Slew Printer to Top of page 


63 X 


Shift Right Double (binary) 


22 


Shift Right Double Alpha 


22 


Shift Right Double Alpha and Set 


22 


Shift Right Double Decimal and 




Set 


22 


Shift Right Double (binary) Test 


22 


Seek/Read File 


14 X 


Seek/Read File and Increment 




address 


16 X 


Seek/Read File and Release seek 


15 X 


Shift Right Quadruple Alpha 


22 


Shift Right Quadruple Alpha and 




Set 


22 


Shift Right Quadruple Decimal 


22 



* 2A in this column indicates a two-address instruction. 

X An X following an Octal Code indicates that the octal value is a 
command code, not an operation code. 
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Mnemonic Code 



Computer O peration 



Octal 



SRQDS 




Shift Right Quadruple Decimal 








and Set 


22 


SRS 




Shift Right Single (binary) 


22 


SRSA 




Shift Right Single Alpha 


22 


SRS AS 




Shift Right Single Alpha and Set 


22 


SRSD 




Shift Right Single Decima:. 


22 


SRSDS 




Shift Right Single Decimal and Set 


22 


SRST 




Shift Right Single (binary) Test 


22 


SRTA 




Shift Right Triple Alpha 


22 


SRTAS 




Shift Right Triple Alpha aad Set 


22 


SRTD 




Shift Right Triple Decimal 


22 


SRTDS 




Shift Right Triple Decimal and 








Set 


22 


SSA 


(2A) 


Set Status by ANDing 


67 


SSL 


(2A) 


Set Status by Loading 


67 


SSO 


(2A) 


Set Status by ORing 


67 


STD 




Store Double 


45 


STQ 




Store Quadruple 


47 


STS 




Store Single 


44 


STT 




Store Triple 


46 


SWF 


(2A) 


Seek/ Write File 


10 X 


SWFI 


(2A) 


Seek/Write File and Increment 








address 


12 X 


SWFR 


(2A) 


Seek/ Write File and Ptelease seek 


11 X 


SWFV 


(2A) 


Seek/ Write File and Verify 


13 X 


SXA 


(2A) 


Store Index in Address field 


32 



2A in this column indicates a two-address instruction. 

An X following an Octal Code indicates that the octal value is a 
command code, not an operation code. 
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Mnemonic Code 

TIA 
TIO 
TOA 
TOO 

VLD 
VLM 

WB 

WEF 

WF 

WFCF 

WFCR 

WFCV 

WFI 
WFR 

WFV 
WTB 
WTD 

X 

XL 

XP 

X* 

XL* 

XP- 



* Computer Operation 

(2A) Type Input - Alphanumeric 

(2A) Type Input - Octal 

(2A) Type Output - Alphanumeric 

(2A) Type Output - Octal 

Variable Length Divide 
Variable Length Multiply 

(2A) Write Buffer 

(2A) Write End of File 

(2A) Write File 

(2A) Write File Continuous and 

Release seek 

(2A) Write File Continuous, Verify 

and Release seek 

(2A) Write File and Increment address 

(2A) Write File and Release seek 

(2A) Write File and Verify 

(2A) Write Tape Binary 

(2A) Write Tape Decimal 

Index 

Index Link 
Index Pointer 
Index Indirect 
Index Link Indirect 
Index Pointer Indirect 



Octal 



03 


X 


01 


X 


13 


X 


11 


X 


26 




27 




30 


X 


55 


X 


50 


X 



31 



33 


X 


52 


x 


51 


X 


53 


X 


15 


X 


14 


X 


00 




02 




01 




10 




12 




11 





* 2A in this column indicates a two-address instruction. 

X An X following an Octal Code indicates that the octal value is a 
command code, not an operation code. 
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B. ALPHABETIC LISTING - PSEUDO OPERATIONS 







Manual 


Mnemonic i 


Code 


Page 


ACUM 




1-108 


AN 




1-116 


ABP 




1-104 


ARPL 




1-106 



Pseudo Operation 

Accumulator 

Alphanumeric constant 

Accumulator Reference Point 

Accumulator Reference Point in 
the Loader area 



BPS 
BPSL 

BSS 
BSSL 



1-96 Block Preceded by Symbol 

1-98 Block Preceded by Symbol in the 

Loader area 

1-92 Block Started by Symbol 

1-94 Block Started by Symbol in the 

Loader area 



CALL 



Call segment at load time 



DECD 

DECQ 

DECX 

DECT 

DGR 

DGRE 

DGRR 

DIG 

DXG 



1-114 Decimal Constant Double word 

1-114 Decimal Constant Quadruple word 

1-114 Decimal Constant Single word 

1-114 Decimal Constant Triple word 

1-8 3 Define Global Reference 

1-82 Define Global Reference Ends 

1-79 Define Global Reference Remotely 

1-75 Define Internal Global symbols 

1-77 Define External Global symbols 



END 
EJT 



1-137 End of program 

1-123 Eject page 
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Manual 




Mnemonic Code 


Page 


Pseudo Operation 


EQU 


1-130 


Equals 


EQUG 


1-85 


Equals Global synnbol 


EQUO 


1-132 


Equals Octal 


FILL 


1-111 


Fill word 


FULL 


1-125 


Full binary cards 


IDEN 


1-124 


Identify binary output 


INCL 


1-89 


Include Library segment 


INCS 


1-90 


Include Symbolic segment 


LSAN 


1-118 


Last Symbol Alphanumeric 


LSB 


1-100 


Last Symbol in Block 


LSBL 


1-120 


Last Symbol in Block in the 
Loader area 


OCTD 


1-120 


Octal Constant Double word 


OCTQ 


1-120 


Octal Constant Quadruple wi 


OCTS 


1-120 


Octal Constant Single word 


OCTT 


1-120 


Octal Constant Triple word 


ORG 


1-127 


Origin 


OR GO 


1-129 


Origin Octal 



PRFX 



1-133 



Prefix 



SGMT 


1-73 


Segment Name 


SYAL 


1-126 


Symbolic Analyzer 


TCD 


1-136 


Transfer Control Card 


TTL 


1-122 


Title 
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SUPPLEMENT TO CHAPTER IV 



The possibility of generating relocation errors was discussed in Chapter 
IV.. In that Chapter, expressions containing only the pluEi (+) and minus 
(-) operators were considered. On occasion, the programmer may wish 
to employ the multiplication (*) and division {/) operators and have the 
assembler calculate these more complex relationships. Because this is 
a more complex environment, it is natural to expect that the assembler's 
procedure for detecting relocation errors is more complex. However, it 
is essential that the programmer understand this proceduire if errors are 
to be avoided during coding. 

The procedure which follows is mainly applicable to comjjlex expressions; 
however, it is general enough to be used on simple expressions, too. This 
stems from the fact that the assembler itself has only one procedure for 
detecting relocation errors. 

The example which follows is a contrived, unreal vehicle, intended only 
to portray many aspects of relocation errors. 

Pr i iliminary Procedure 

Step 1 Partition the expression into simple and complex groups. A 
simple group is one element (a symbolic reference or an 
absolute value) which is connected to the expression by either 
the plus or minus operator. A complex group contains two or 
more elements (symbolic references and/or absolute values) 
that are connected to each other by either the multiplication 
or division operators. The complex group, itself, is connected 
to the rest of the expression by either the plus or minus sign. 

Therefore, in the expression 

A*B/C-r>-5*E*F+16+22*G 

A*B/C Constitutes a complex group, 

D Constitutes a simple group (an element), 

5*E*F Constitutes a complex group, 

16 Constitutes a simple group (an element) and 

22*G Constitutes a complex group. 

Stej) 2 Each simple group (element) is examined. If tlie group 

(element) is absolute it will have no effect on the expression 
and is therefore dropped from consideration. Thus, in the 
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previous example, the absolute value 16 is immediately 
ignored. If D represents an absolute symbolic reference, 
it is also ignored: however, if it represents a symbolic 
reference, it is retained. 

Step 3 Each complex group is examined. 

a; If each element in the group is absolute it will have no 
effect on the expression and is therefore di'opped from 
consideration. Thus, in the example above, if symbolic 
references A, B and C were all absolute, the complex 
group A*B/C would be ignored. 

b) H there is more than one relocatable symbolic reference 
in the complex group, the entire expression is meaning- 
less and a relocation error is flagged on the assembly 
listing. Thus, in the previous example, if symbolic 
references E and F were both relocatable, the entire 
expression is in error. 

c) If the complex group contains one relocatable symbolic 
reference and the division operator appears anywhere in 
the group, the entire expression is meaningless and a 
relocation error is flagged on the assembly listing. 
Thus, in the example above, if symbolic reference A 

was relocatable, the entire expression is in error because 
of the presence of the division operator. 

Substitution Procedure 

The substitution procedure is performed if no errors were discovered 
in the preliminary procedure. 

a) Each absolute symbolic reference is replaced by its 
absolute value. Thus, in the previous example, if the 
symbolic reference F has a value of 4, the result of 
the absolute substitution would be: 



-D-5*E*4+22*G, 
-D-20*E+22+G 



or 



Note : 

The absolute value 16 has been dropped from consideration during the 
preliminary procedure and, in order to continue the example, complex 
group A*B/C is assumed to contain only absolute elements. 
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b) Each relocatable symbolic reference is replaced by the 
letter M since it will be moved by the loader. If symbolic 
references D, E, and G are assumed to be relocatable, 
the resulting expression will be in terms of one unknown, 
M: 

-M-20+M+22M 



F inal Determination 

After like terms are combined according to the rules of mathematics, 
the result will indicate one of three possible conditions: 

1. if the result is or nothing, the adilress is absolute 
and cannot be moved. 

2. if the result is M, the address is relocatable and must 
be moved. 

3. if the result is anything else, the address is a reloca- 
tion error. 

In the example, then, the result of combining like terms produces: 

22M - 21M or 

M 

This result indicates that the original expression is relocatable. 
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I. INTRODUCTION 



The Macro Assembly Program offers a macro source language and the 
means for translating this language into the instruction format of the 
GE-425/435 computer. In the basic assembly language, a code exists 
for each operation which the computer can execute. The macro assem- 
bly language provides instructions which produce a series of these 
operation codes. The macro language performs operations upon data 
described in a field- oriented manner and is a logical extension to the 
basic assembly language. 

Macro- instructions simplify the problem of programming, because they 
eliminate many of the tedious coding tasks. These instructions relieve 
the programmer of such details as masking and aligning data. In this 
way, the opportunity for introducing errors into the source program is 
greatly reduced. The programmer may choose to write his entire pro- 
gram in the macro assembly language, or he may combine basic assembly 
operations with macro operations. 

The macro assembly language provides instructions which will accom- 
plish the following functions: 

Input/output operations 

Arithmetic operations 

Data movement 

Procedure control 



Additional macro- instructions may be added to the source language. 
Generator(s) required to process the new macro instruction{s) may be 
written by the customer in either the macro or basic assembly lan- 
guages, or may be added to the Macro Assembly Program by means of 
a library routine. 



The Macro Assembly Program achieves the following objectives. The 
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program includes: 

A minimum but adequate set of field- oriented macro- instructions 

All machine and pseudo- operations available in the basic assembly 
language 

A detached Data Division with a fixed format 

A means for making the automatic input/ output routines avaiilable 

A source language that is easily used by the programmer and eas ily 
assembled 

An Identification Division that provides adequate source program 
documentation. 

The Macro Assembly Program has the following capabilities. The pro- 
gram: 

Performs a straight basic assembly without executing unnecessary 
phases of the Macro Assembly Program 

Allows new macro instructions to be added to the system 

Is upward compatible with future GE-400 series computers 

Provides extensive error analysis of the source language 

Performs a rapid assembly of source programs. 



SYSTEM CONFIGURATION 

The Macro Assembly Program operates on the following configuration : 

GE-425/435 computer with 8K memory 

Magnetic tape control unit 

Four tape handlers 

Printer 
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Card reader 
Card punch 

Additional magnetic tapes may be substituted for the card reader card 
punch, or the printer. The Macro Assembly Program takes adv^tage 
of the 16K or 32K core memory options as illustrated in Figure M 
below: 



System 
Tape 



Scratch 
Tape 




OR 



_ 8K jmiORY 

_l«_>mi0RY 

32K MEMORY 



CARD READER 



Q 



OR 



PRINTER 



© 



OR 



CARD PUNCH 



"1 
I 

© 



Figure I- 1 



n. THE SOURCE LANGUAGE 



The Macro Assembly Program source language resembles English gram- 
mar and can be readily understood. It is composed of certain combina- 
iions of characters or "words" which, when written according to given 
conventions, describe an information processing function. 

The words of the macro assembly language are made up of characters 
::rom the standard GE character set. This includes: 

Alphabetics A Z 



Numerics 



0, 1 



plus the tilde (J). There must be no imbedded blanks. 

lA^en writing in the macro assembly lan^^age, there are two types of 
words which must be considered. First, there are the macro instruc- 
tions, which generate the actual computer operations. Second there 
axe the words with which a programmer describes his data or 'allocates 
memory for the location of this data. These words are written by the 
programmer in a manner which is easily understood, but which of neces- 
sity must follow certain conventions. These will be discussed later in 
tiis section of the manual. The types of words used in the source lang- 
uage are illustrated below. The underlined words are the macro-instruc- 
tions. 

START OPEN INPUT;PAY-^MSTR;TIMECDS 

READ PAY-MSTR 

A Macro Assembly Source Program consists of four divisions: 

IDENTIFICATION DIVISION 

ENVIRONMENT DIVISION 

DATA DIVISION 

PROCEDURE DIVISION 

The function of each of these divisions is .discussed briefly in this chapter 
tc present an all-over view of the source Language. 
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identifies his program and 



In the Identification Division the programmer 
labels the outputs of the assembly. 

In the Environment Division, the programmer describes the character- 
istics of the object computer and specifies the major control routines 
required by the Extended Input/ Output System. 

In the Data Division, the programmer describes the format of the data 
files and allocates memory for file areas, working storage, and con- 
stants. 

In the Procedure Division, the programmer writes macro-instructions 
and/ or basic assembly language operations and pseudo- operations which 
define the functions to be performed. The instructions in this division 
operate on the data described in the Data Division. 

In the section describing the basic assembly language, the concept of 
relocatable segments was discussed. It is possible in writmg in the 
macro assembly language, to produce relocatable segments for use with- 
in the GE- 425/ 435 operating system environment. Each segment written 
must be named in the Identification Division and be specified as to whether 
it is to be a relocatable or absolute assembly. More details describing 
the communication between segments is discussed in Chapter VIII, Seg- 
mented Programs. 
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III. PROGRAMMING FORM FIELDS 



The macro assembly language uses both levels of the dual lieadmgs on 
the GE-425/435 Programming Form. This chapter discusses the place- 
ment of the four divisions of the source language on this form, and de- 
fines the fields used where necessary. The sample coding in Figure Ill- 
is shown merely to illustrate placement; the various entries are discussed 
in detail in the Chapters describing the four divisions. 

IDENTIFICATIONADIVISION is written into columns 8-30. Each entry 
within this division starts in column 17. Descriptions of any of the op- 
tions which may be used with each entry are written in the Operation 
Parameters, starting in column 25. Comments may be written into the 
Identification Division by inserting an ♦ in column 7. 

ENVIRONMENTADIVISION is written into columns 8-27. Each entry staj-ts 
in column 17. Parameters for the individual entry are written in the Oil- 
eration Parameters, starting in column 25. 

DATA-DIVISION is written in columns 8-20. This division uses the lower 
level of headings across the programming form. A brief definition of 
each of these fields follows: 

Sequence (Cols. 1-6) 

The Sequence number is provided as a convenient method for the pro- 
grammer to maintain an order within his source deck. 

Type (Col. 7) 

This column describes the use of the line in whicli it appears. 

Data Name (Cols. 9-16) 

The data name is the name a programmer assigns to an entry in the 
Data Division. 

Level_ (Cols. 18-19) 

With al£vel entry, the programmer defines the various levels of a logi- 
cal record and indicates unrelated items in working storage. 
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Figure ni-1. Sample Piogriimming Form 



Sync (Synchronization) (Col. 21) 

The Sync entry specifies the positioning of elementary items within a 
computer word or words. 

Use (Col. 23) 



The Use column specifies how a data item is to be used in memory. 

Picture (Cols. 25-40) 

The Picture field describes the mode, size, decimal point location, and 
editing characteristics of the data name entry. 

Occurs (Cols. 41-44) 

The entry in the Occurs columns indicates the number of times an item is 
to be repeated. 

Value (Cols. 45-76) 

The Value columns specify an initial value for data items in the Working 
Storage Section. 

Iden (Identification) (Cols. 77-80) 

The Iden columns associate the individual card with a source program 
deck. 

PROCEDURE A DIVISION is written in columns 8-25. This division uses 
the upper level of headings plus those headings which apply to both Pro- 
cedure and Data Divisions. A brief definition of tliese fields follows: 

Type (Col. 7) 

The Type column is used to indicate a comhient or continuation line. 

R e f erence Symbol (Cols. 9-16) 

Tnr; Reference Symbol field is used to assign symbols to the instructions 
'<:'.'i pseudo- operations written in the Procedure Division. 

0;.';ra tion (Cols. 17-24) 

." ■': Operation entry is a mnemonic code: a macro instruction, instruc- 
. :rom the GE-425/435 instruction repertoire, or a pseudo-operation. 
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Operation Parameters (Cols. 25-76) 

The parameters entered into the Operation Parameter columns complete 
the function indicated by the Operation. 

Iden (Cols. 77-80) -- same use as in Data Division. 
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IV. IDENTIFICATION DIVISION 



In the Identification Division the programmer identifies the source pro- 
gram, labels the output from the assembly, and specifies an absolute 
or a relocatable assembly. This division is written first on the 
GE-425/435 Programming Form. 

Any Macro Assembly Program begins with IDENTIFICATIONADIVISION 
written into columns 8-30. The only required entry within the division 
is SEGMENT. The remaining entries are optional. Comments may be 
included in the Identification Division by inserting an * in column 7, and 
then writing the comments in columns 8-80. 

IDENTIFICATION DIVISION ENTRIES 

The four permissible entries in the Identification Division are 

SEGMENT 

AUTHOR 

TITLE 

IDEN 

Each entry is written starting in column 17. A description of the options 
which may be used with each entry is described in the following paragraphs. 
The options are written in the Operation Parameters columns starting 
in column 25. 



SEGMENT 



Required 



In the SEGMENT entry the programmer names his segments (programs). 
This entry allows the programmer to specify an absolute origin for the 
segment, thus giving him the ability to assemble in the absolute mode. 
This entry is required and must precede the other entries in the division. 
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Format 



The format for the SEGMENT entry is as follows: 

OPERATION OPERATION PARAMETERS 



SEGMENT 



TBlanks 
Segment name ( ;Expression 

;Absolute decimal valo' 






The segment name should be a unique name which will be written on the 
output program header card. The segment name must follow the rules 
established for Reference Symbol on page 2-59 . 

The second parameter, which immediately follows the segment name 
shDuld contain one of the following: 

Blanks Blanks indicate the relocatable mode of assembly. 

All instructions are assembled relative to zero; the 
assembly listing is relative to zero: relocatable errors 
are flagged. 

Expression The expression must contain one external global 

symbol. Thesymbolmust adhere to the general res- 
trictions placed on external global symbols in the 
discussion of DXG in the Basic Assembly Language 
section, page 1-77 . This condition indicates the re- 
locatable mode of assembly. 

Absolute The absolute value defines the origin of the segment 

Decimal and indicates the absolute mode of assembly All 

Value instructions are assembled relative to the starting 

origin and the assembler produces an absolute listing. 
Relocatable errors are flagged for warning purposes 
only. The program may be moved by changing the 
starting address on the output origin card. 



Examples 



1.^.. 



^ E F E H F-- N C !=■ S • ■^' Fl - 



D ,LM^l_,lJf, L. C 






M^ e 
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This example indicates that the name of the segment is GROSPAY. Since 
the segment name is followed by blanks, a relocatable assembly is in- 
dicated. 

2. 



REFeRENCE SYMBOL 


1 


OPERATION PARAMETERS 


DATA NAME 
9 16 


17 


LEVEL 
IB 19 






.2 


E 


24 


p r r T U R F 
5 5 40 


o c c 

41 


,_„ 




l"s_;nr\ 






— 






. -I., 1. .„J 1 1 L ,. , 

I .._i L. _ J 1.. i. .. . 


s 


f |nX 


F.1.C.A,L ' T I.M,r. CAiL.i-.S.O 


0, 









This example indicates that the name of the segment is FICAL. Since 
the segment name is followed by a symbolic reference (an external global 
reference), a relocatable assembly is indicated. 



-s LaG m 



:.N.T, lT,I JA.£.C.A.i-. >.LC)_^itx 



This example indicates that TIMECAL is to be used as the name of the 
segment. Since the segment name is followed by a decimal value, an 
absolute assembly is indicated. 



IDEN 



Optional 



IDEN allows the programmer to specify the identification (columns 77-flO) 
of the binary program cards. If used, the four identification characters 
written in columns 25-28 of this entry will be placed in columns 77-80 
of the output deck. If IDEN is not supplied, columns 77-80 of the outpu; 
deck will be blank 



EXAMPLE OF A TYPICAL IDENTIFICATION DIVISION 



I 1^ t rJ T 1 F, J 



i .1. fl i ^J t i 



S i S m ■ - 

T 1 T.L 
I i)(. w 



i.L ,C U.L.A.T.L. .G.R.g^.i.^ 



T.T.£ w, : ^,- , 



' L.D. 1 N >: 3i.\-.\\ifiM £i.. 



AUTHOR 



Optional 



The author's name may contain up to 30 BCD characters and should be 
written starting in column 25. 



TITLE 



Optional 



The use of Title allows a heading line to be specified that will be printed 
dt the top of each page of the assembly listing. The print line is written 
in columns 25-76. 
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V. ENVIRONMENT DIVISION 



The Environment Division enables the programmer to indicate the char- 
acteristics of the object computer and to specify the major control routines 
required by the Extended Input/ Output System for execution of the object 
program. This division follows the Identification Division on the 
GE-425/435 Macro Assembly Program Programming Form. 

The environment division must begin with a line that contains 
ENVIRONMENTADIVISION written in columns 8-27. The SRMETHOD 
entry is required for every Macro Assembly Program. If the SRMETHOD 
is not specified the CALL option will be assumed. All other entries in 
the Environment Division are optional. 



ENVIRONMENT DIVISION ENTRIES 

The following list of entries may be included in the Environment Division: 

SRMETHOD 

MEMSIZE 

DEFCHKPT 

DEFOPEN 

DEFCLOSE 

DEFEOR 

DEFSCHED 

The name of the entry is written starting in column 17. Parameters for 
the individual entries are written in the Operation Parameters columns 
starting in column 25. A detailed description of the entries and allowable 
parameters follows. 
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SRMETHOD 



Required 



The SRMETHOD entry defines the method by which any non- generated 
routine is to be incorporated in the object program. The parameters 
ir the Operation Parameters columns are: 



INCL 



mcs 



CALL 



Non- generated routines are incorporated by INCL. 
Include Library Segment (INCL) indicates that the 
required segments are supplied from the library tape 
at assembly time. 

Non-generated routines are incorporated by INCS. 
Include Symbolic Segment (INCS) will call routines 
from the program library which are kept in symbolic 
form and assemble them with the current segment. 

The required non-generated routines will be incor- 
porated by the loading program at execution time. 
If CALL was specified, the latest version of each non- 
generated routine will be incorporated in the program 
from the library tape when the program is loaded. 



MEMSIZE 



Optional 



The MEMSIZE entry specifies to the Macro Assembly Program the 
amount of memory available for this segment in the object program. 
Memory size should be written as a decimal number beginning in column 
25. 



DEFCHKPT 



Optional 



Tlie DEFCHKPT entry defines the checkpoint routine to be used. If this 
entry is omitted, it indicates that no checkpoint is to be taken. 
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There are two parameters, separated by a semicolon, required for this 
entry. The first parameter specifies the procedure to be performed 
after writing the checkpoint; the second specifies a magnetic tape unit 
upon which the checkpoint is to be written. 

The entries for the first parameter are: 

PROCEED Continue processing after writing the checkpoint . 



HALT 



Halt immediately after writing the checkpoint. Pro- 
cessing will be continued when the operator depresses 
the "RUN" button. HALT is useful for programs that 
process a large number of records on the card reader, 
card punch, or document handler. It allows the oper- 
ator to "batch" these records to facilitate re-start. 



DEFCLOSE 



Optional 



When the DEFCLOSE entry is supplied the Macro Assembly Program 
will generate the INCL, INCS, or CALL for the CLOSE routine. 
CLOSEl must be written in the Operation Parameters field starting in 
column 25. 



DEFEOR 



Optional 



The entries for the second parameter are 



Blanks 



04XX 



Any checkpoints will be written on the standard dump 
tape (logical device 0402„). With this option, the semi- 
colon is not required following the first parameter. 



FILENAME 



Where 04xx8 is the logical device number of a magnet 
tape on which the checkpoints should be written. 

The name of magnetic tape data file on which the check- 
points are written. FILENAME must be described 
in the Data Division. 



ic 



Any checkpoints written on data tapes are .automatically by-passed by 
the Extended Input/ Output System when those tapes are used as input. 



DEFOPEN 



Optional 



It the DEFOPEN entry is included, it will incorporate the OPEN routine 
according to the SRMETHOD specified. NON~OVERLAY must be written 
in the Operation Parameters field starting in column 25. 
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K DEFEOR is supplied, the Macro Assembly Program will generate the 
INCL, INCS, or CALL necessary to incorporate the end-of-file pro- 
cessing routine. K the program is to process magnetic tape files, this entry 
is necessary, and the parameter EORl must be written starting in 
column 25. 



DEFSCHED 



Optional 



The DEFSCHED entry defines the type of buffer processing and scheduling 
routines to be incorporated in the object program. If DEFSCHED is 
omitted, the buffer processing and scheduling routines will not be included 
in the program. The parameters which may be used in the Operation 
Parameters columns are 



GENERATIVE 



INTERPRETIVE 



If this option is specified, all of the buffer pro- 
cessing routines and parts of the scheduling 
routines will be generated. The generated 
routines will be highly time efficient at the ex- 
pense of memory. 

If the programmer desires core efficiency at 
the expense of execution time, this option 
should be selected. In this case, one interpre- 
tive buffer processing routine and one interpre- 
tive scheduling routine will be produced for the 
program. 
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EXAMPLE OF A TYPICAL ENVmONMENT DIVISION 



VI. DATADPnSION 




The Data Division describes the input and output files to be processed 
and allocates memory for input/output buffers, intermediate work areas, 
tables, and constants. The data may be described either without regard 
to word boundaries, or the positioning of the fields witliin words may be 
controlled. All field characteristics of the items of data such as data 
name, mode, size, and initial value, if any, must be supplied by the 
programmer. 

The Data Division consists of two sections: the File Seiction and the 
Working Storage Section. The File Section contains inl'ormation about 
the physical characteristics of input and output files, and descriptions 
of the records which are contained in these files. The Working Storage 
Section may contain descriptions of intermediate data which is developed 
during the execution of the program, constants which are assigned initial 
values, switches which may be required by the program logic, and infor- 
mation that may be used to format output lines. 



WRITING THE DATA DIVISION 

When writing a program in the macro assembly language, the Data Divi- 
sion is the third division to appear on the programming form. 
DATAa DIVISION, entered in columns 8-20, identifies this division on 
the form. Conventions governing the entries which appear in the pro- 
gramming form fields are presented in the following pages. 



SEQUENCE 



(Cols. 1-6) 



Purpose 

The sequence number is provided as a convenient method for the pro- 
grammer to maintain an order within his source deck. 

Assembler Action 

If the sequence check option is specified on a language processor option 
card, the sequence number assigned by the programmer will be checked, 
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using the GE-425/435 collating sequence. If any source program card 
is detected with a sequence number equal to, or less than, the preceding 
card, it will be flagged as a possible error in the program listing. 



DATA NAME 



(Cols. 9-16) 



Purpose 

A data name is used to identify an entry in the Data Division. 

Conventions 

When writing a data name the following conventions must be observed. 
Data names — 

1. must be one to eight characters in length. 

2. must be formed from the alphabetic characters A-Z, the 
numerics 0-9, and the tilde (~). 

3. must be defined only once in a program. 

4. must contain at least one alphabetic character. 

5. must not contain imbedded blanks. 

Data names may be floated anywhere within the eight column field. 
Any field that is to be referred to in the Procedure Division must have 
a data name. K a field is to be used only as a filler in a record des- 
cription or a print line in Working Storage, the data name columns may 
be left blank. 



Examples 



PAYMASTR 

PAYREC 

PAY- NO 

DCODE 

A25 

15B 



2-22 



12/6/63 



LEVEL 



(Cols. 18-19) 



Purpose 

The Level numbers written in these columns define the relative struc- 
ture of a logical record and indicate unrelated items in Working Stora^fe. 

Concept of Levels 

There are a maximum of four levels, 01 through 04 with the leading 
zero being optional. Level 01 indicates logical record entries in both 
the File Section and Working Storage, and in addition is assigned to 
items of data which are not a part of a logical record. This unrelated 
data occurs only in the Working Storage Section, because all entries in 
the File Section describe logical entries within the file. 

Any data subordinate to another level carries a higher level number. 
Therefore, a field within a record would be assigned a level 02, a sub- 
field would be assigned an 03, and any item within a subfield would be 
assigned an 04. Any data item which is not further subdivided is 
referred to as an elementary level or item. Items further divided are 
called groups. 

Any item referred to as a group is assigned a data name at the group 
level and is referred to by that name. The group includes all sub- 
sequent groups and items until a level number less than or equal to the 
level number assigned to the group is encountered. 

Reference to a group data name by an operand in a macro-instruction 
dictates that each item within the group is to be included. Thus, by 
grouping data, the programmer may operate on several items of data 
with one macro-instruction, instead of operating on each item indivi- 
dually. 

Note: 

Any reference to a group refers only to a string of characters with no 
editing. 
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Example 































REFER FNCE SVW80L 


O P E R* 


TlON 




OPERATION PARAM 


E T E R 5 
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LEVEL 
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In the example just given , the logical record PAYREC is subdivided 
into three major parts (PAY'- NO, DATE, and NAME). Any reference 
to PAYREC Includes all of the items down through LASTNAME. DATE 
is subdivided into MO, DAY, and YR and is, therefore, a group. Any 
reference to DATE will include the tliree subfields. Since MO, DAY, 
and YR are not further subdivided, they are elementary items. There- 
fore, a reference to MO will apply only to that data item. 

The employee's NAME is subdivided in the same manner, with ISTINIT, 
2NDINIT, and LASTNAME as elementary data items. INITIALS is a 
group which includes ISTINIT and 2NDINIT, and the group NAME in- 
cludes INITIALS and LASTNAME. 

Whenever the 01 level is introduced, it terminates any association with 
the prior entries. Thus, unrelated items of data being written in the 
Working Storage Section, such as constants, switches, index words, 
temporary storage, should be introduced at an 01 level. 



PICTURE 



(Cols. 25-40) 



Purpose 

An entry in the Picture columns describes the mode, size, decimal 
point location, and editing characteristics of the field represented by 
the data name. Picture is used in both File Section and Working 
Storage Section. 
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Picture must be specified for each elementary item unless the usage is 
Index or Switch. Picture can be specified only at the elementary item 
level. 

Two types of characters may be specified in Picture: characters 
describing data and characters which specify editing of the data 
field. 

Non-Edit Characters 

• Data Characters — The following non-edit characters represent 
data as indicated: 

9 Numeric character (0, 1,. . . . 9) 

X Alphanumeric character (any character) 

A Alphabetic character (A, B, Z ajid blank) 

These characters are repeated as many times as necessary to 
indicate the number of characters in an elementary item. Numeric 
items must not exceed 16 digits. There is no restriction to the 
size of alphanumeric or alphabetic items. The ciiaracters may be 
written in either of the following ways: 



99999 


9(5) 


xxxxxxx 


X(7) 


AAAA 


A(4) 



The decimal integer enclosed in parentheses following the picture 
character indicates the number of consecutive occurrences of that 
character. 

• Operational Symbols -- The following Picture chEiracters are 
operational symbols and do not represent character positions in 
the field: 

S An S in the Picture columns means that the data field might 
have a sign. The S must be the first chai'acter of the 
Picture. 

V An implied decimal point location is indicated by a V in the 
appropriate position in the Picture colunuis. 

Edit Characters 

The characters which specify editing of a data field ai'e described on 
the following page. 
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Zero Suppression Characters -- The following Picture characters 
represent leading numeric characters which are to be replaced 
when zero: 

Z Replace zero in corresponding data character with a 

blank (a). 
* Replace zero in corresponding data character with an 

asterisk (*). 

Insertion Characters — Each of the following Picture characters 
indicates that said character is to be inserted in the corresponding 
character position of an elementary item: 

$ dollar sign (two or more adjacent $ characters indicate 

floating dollar sign) 
, comma 

decimal point 
B blank 



Report Sign 



as the last Picture character indicates that a 



minus sign is to be inserted in the last character position of a 
negative field. If the field is positive, a blank is inserted in the 
last character position. 



Conventions 

Reference to the examples which follow these conventions may help in 
understanding them. 

1. All characters, except the operational symbols S and V are 
counted in the length of the item. 

2. A picture cannot contain more than one decimal point (either 
a V or a period (.) ). 

3. A Z or an * can be preceded in the Picture only by a single 
leading $, a decimal point (V or .), or a comma (,). 

4. An item whose Picture indicates zero suppression with a 
floating dollar sign, must contain at least one more position 
than the maximum number of significant digits to be stored 
in it. A dollar sign replaces the least significant suppressed 
zero indicated by a $ in the Picture. Every other suppressed 
zero is replaced by a blank. 
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10. 



If any type of zero suppression is specified in the Picture, the 
suppression also applies to leading commas. 

No one of the Picture characters, Z, ", or $ ma.y appea:!" to thu 
right of a decimal point (.), unless every numeric character 
position is represented by Z, *, or $, respectively. 

If all data characters of an item are represented by Z'si, by 
*'s, or by $'s, then the item is blanked when the value of the 
data is zero. In such a case, all other editing is overriden. 

The Picture characters $, comma (,), (.), S, and V can only be 
used with a numeric field. 

When an item whose Picture contains editing characterti is 
used as a source, it is treated as an alphanumeric item. 

A Picture can have no more than 16 characters, including 
editing characters; it cannot be continued onto a new lirie. 
However, the Picture may represent more than 16 characters 
by using a decimal integer enclosed in parentheses to indicate 
the number of occurrences. (See Convention 1.) 



Examples 



Non-Edited 



Source Area 


Receiving 


Area 


Picture 


Field as in 


Field will be 


Class 


is: 


memory: 


used as: 


is: 


99999 


56789 


56789 


NUMERIC 


9(3)V9(2) 


56789 


567.89 


NUMERIC 


S999V99 


5678R 


-567.89 


NUMERIC 


XXXXX 


ABCDE 


ABCDE 


ALPHANUMERIC 


AAAAA 


BCDEF 


BCDEF 


ALPHABE"IC 


X(5) 


12345 


12345 


ALPHANUMERIC 


XXXXX 


AB67C 


AB6 7C 


ALPHANUMERIC 


99X99 


67.89 


67.89 


ALPHANUMERIC 


99AA9 


23FG4 


23FG4 


ALPHANUMERIC 


A(2)X(3) 


BD2M3 


BD2M3 


ALPHANUMERIC 


S9999 


1234 


1234 


NUMERIC 


S9999 


123M 


-1234 


NUMERIC 
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Edited 



Source Area 


Receiving Area 


Picture 


Field as in 
memory; 


Picture 


Edited Field 


9(5) 


45678 
45678 


$ZZ,ZZ9.99 


$45,678.00 


999V99 


$ZZ,ZZ9.99 


$ 456.78 


999V99 


C0067 


$ZZ,ZZ9.99 


$ 0.67 


999V99 


06700 


$ZZ,ZZ9 


$ 67 


999V99 


00004 


$ZZ,ZZZ.99 


$ .04 


999V99 


00000 


$ZZ,ZZZ.99 


$ .00 


9(5) 


00000 


$ZZ,ZZZ.ZZ 




V9(5) 


12345 


$ZZ,ZZ9.99 


$ 0.12 


9(5) 


12345 


$**,**9.99 


$12,345.00 


9(5) 


00123 




$***123.00 


9(5) 


00000 


S»« "fCfcft iSrA 




9(5) 


6 7890 


$$$,$$9.99 


$67,890.00 


999V99 


6 7890 


$$$,$$9.99 


$678.90 


999V99 


01234 


$$$,$$9 


$12 


999V99 


00000 


$$$,$$9.99 


$0.00 


999V99 


00000 


$$$,$$$.$$ 




999V99 


00001 


$$$,$$$.$$ 


$.01 


V9(5) 


6 7890 


$$$,$$9.99 


$0.6 7 


S9(5) 


0056P 


ZZZZZ.99- 


567.00- 


S9(5) 


0056P 


ZZZZZ- 


567- 


9(5) 


56789 


BBB99.99 


89.00 


9(5) 


56789 


BBB99 


89 


999V99 


56789 


999. BE 


567. 


999V99 


56789 


999.99 


56 7.89 


9(5) 


00567 


ZZZZZ.99- 


567.00 
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VALUE 



(Cols. 45-76) 



Purpose 

The Value columns specify an initial value for data ittims in the Working 
Storage Section 

Conventions 

1. The value may be written either as an a^Lphariumeric or numeric 
literal. However, it must agree with the class specified in the 
Picture. 

2. Alphanumeric or alphabetic values must be enclosed in quota- 
tion marks. The length and mode of the data within the quota- 
tion marks must agree with the Picture suppJ.ied for this item. 

3. The lei^h of a numeric value written in these columns must 
be equal to, or less than the number of data characters speci- 
fied in the Picture columns. 

4. If a decimal point is included in a numeric va.lue, it will be 
treated as an implied decimal point and, therefore, must 
correspond with the implied point location specified in the 
Picture. 

5. The sign of a numeric literal must be the left hand character 
of the literal. Any unsigned literal will be assumed positive. 

6. Value may only be specified at the elementary level. It may 
not be stated in an item which contains an entry in the Occurs 
columns or an item which is subordinate to an item containing 
an Occurs entry. 

Examples 



Picture 

X(5) 

AAA 

A(14) 

X(8) 

9 



Value 



Contents of memory 



"12.34" 

"ABC 

"PAYROLL RECORD' 

"%NET-PAY" 
1 



i::. 34 

ABC 

PAYROLL RECORD 

%lvrET-PAY 
1 
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Picture 



Value 



Contents of memory 



S9V9 
S9(5) 
V999 

S999 


-1.5 

-25673 

.123 

+345 


15 . 
25673 
123 

345 



The following examples illustrate what happens if the value is shorter 
than the picture: 

012 

0123 

1230 

012340 

012340 



999 


12 


99V99 


1.23 


99V99 


12.3 


999V999 


12.34 


S999V999 


-12.34 



SYNC (Synchronization) 



(Col. 21) 



Purpose 

The Sync entry indicates the format of an elementary item that exists 
within an integral number of words. The entries which may be used 
are: 

A The item is not synchronized. 

R The item is right justified within an integral number of 

computer words. 
L The item is left justified within an integral number of 

computer words. 

Sync is used in both the File Section and the Working Storage Section. 

Conventions 

1 . In the File Section, an R or L indicates the data item is con- 
tained in an integral number of words and external format is 
unpacked. Unpacked data is data that is so arranged that it 
may be read (firectly into integral word lengths. The unused 
character positions required to fill the computer words must 
be zero. 
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2. In the Working Storage Section, an R or L specifies the i.nternal 
format of the item. The original contents of the synchronized 
item are unpredictable unless a Value is specified. 

When data is moved by a macro-instruction into an item in 
Working Stor^e or in the File Section, the contents of tlie 
character positions used to fill an integral word will be set 
to zero. 

3. Whenever a synchronized item (R or L) is referenced in the 
source program, the original size of the item as shown in the 
Picture is used in determining any action which depends on 
size, such as truncation. 

4. Synchronization may be specified only at the elementary level. 

5. Synchronization of numeric items (described with 9's in the 
Picture) apply only to digits. The sign is carried in the sign 
position of the right hand word of the field, rather than over 
the units position of the data. 

6. If a data item shares a given machine word with a second 
item, each item is referred to as packed. The data must be 
unpacked each time it is used. 

Examples 

The examples listed below are independent of each other. Assume in 
all examples that the previous field ended in the last character of the 
preceding word. 



Picture 



Sync 



Field in Memory 



X 



2. X 



3. X 



4. A(5) 



^r/ 


XO 


/ 




00 X 


/ 




A A A A a/ 
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5. 
6. 

7. 

8. 

9. 

10. 



Picture 
A(5) 
A(5) 



99 
AA 



SYNC 



Field in Memory 



99 
AA 



99 
AA 



99 
AA 



R 



L 
L 



L 
R 



R 
R 





AAAAAOOO / 




OOOAAAAA /" 




9 9 A A 


Y 




9900AA00 ^ 




990000AA /' 




00990 OAA Z' 



TYPE 



(Col. 7) 



Purpose 

An entry used in the Type column describes the use of the line in which 
it appears. The entries which may be used are: 

* denoting a comment line 

C denoting a continuation line 

R denoting a redefinition of a previously defined area 

Type is used in both the File Section and the Workii^ Storage Section. 

Comment Lines 

An * denotes a comment line. The comment line is carried through to 
the final listii^ for program documentation. There is no restriction on 
the number of consecutive lines which may be used as comment lines. 
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Continiiation Lines 

A C denotes continuation of the Value columns. Whenever a Value, 
including the delimiting quote marks, larger thaji the size of the Value 
columns (45-76), is used, the value must be written out through 
column 76 and continued in column 45 of the next Une. The next line 
must be identified as a continuation line by inserting a C in column 7. 
On a continuation line, only the Sequence, Type, Value, and Iden< 
columns may be used. All other colunms should be Left blank. From 
one to four consecutive continuation lines may be used. 

Example 







Redefine Indication 

An R denotes redefinition and signifies that a data ittsm is to share its 
storage area with the last item of the same level. 
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In the following example, three items are sharing the storage allocated 
to data item AB. 










h. 


L, 


H 


\i:. 






c 


P 






E 





-, i 


^ 1 . 


. X. 


0.5, 


_ n 3 - - 


.01 


?.3_. . 


, &,3 .. . 


5 0.1 



- 


OPERATION 


PARAM 


i£ 


^, 


PIC' 
?5 


•r 


■ 


— 


.. .._.^__., ..^--._^. , 




1 1 


'^1^'^^Il X_^.^ _. 






ft. c 7.;i^^ -. . 




f- +■■■ 





Fields which are redefining the original area are assigned positions 
starting in the leftmost character of the original area. 

For the Data Division entries in the above example, memory will be 
assigned as follows: 

l9 9 9 9l9,9. 9, I Words N & N+1 allocated for data item AB. 

Ill I I I 1 I i 



|A,9,9,9|9|9| I 
C D 



|AA,AA|A,A,A| 



N & N+1 as redefined for data item CD. 



N & N+1 as redefined for data item E. 
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Conventions 



1. All redefinitions of an area must occur directly below tltie 
original data item. 

2. The number of characters in the redefining entry must not 
exceed the size of the original data entry. 

3. Redefinition ends when a level number less than or equal to 
the level of the original data entry is encountered. 

4. Entries redefining an area must not contain a value. It is 
permissible for the original data entry to contain an initial 
value in the Working Storage Section. 

5. Multiple redefinitions are permitted, provided they occur at 
the same level, and there are no intervening entries. 



USE (Usage) 



(Col. 23) 



Purpose 

An entry in the Use column specifies how a data item is to be used in 
memory in either File Section or Working Storage Section. The 
entries which may be used are: 

A The field will be used as specified in the Sync and Picture 
columns, 

S Data field is used as a switch. 

I Data field is used as an index word. 

U This entry is restricted to the File Section. It indicates that 
the data field should be unpacked and right justified as it is 
read into memory or packed when written from memory. U 
cannot be used with any fields which are involved in redefini- 
tion. 

Conventions 

1. The use of S (switch) and I (index) is restricted to Worliing 
Storage and must be used at an 01 level. 
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2. If the data field is specified as a switch, it has an implied 
Picture of 9(4) and may contain an initial value. 

3. A data name specified as an index is established in the 
standard fixed index word format. It may contain a signed 
decimal integer as an initial value. The magnitude of the 
integer may be from 0-32,767. 

4. The Use column may be used only at the elementary level. 

5. If a data item has been defined as synchronized (unpacked 
L or R) on the external media, it is not necessary to insert 
a U in the Use column. It will be brought in as an unpacked 
item and retain the synchronization specified. 

6. When several data items aje defined between two entries 
with a U in the Use column, they will also be read in or 
written out right justified and unpacked. 

Examples 

These examples illustrate the function of the U. All examples assume 
that the data on external media consists of — 



Field No. 


Data 


1 


111 


2 


B 


3 


33333 


4 


DD 


5 


5 



Picture 

999 

A 

9(5) 

XX 

9 



The same set of Pictures is used in all examples. The data on the 
external media is assumed to be a string of packed characters: 

111B33333DD5 



Use 



Picture 



Data in Memory 



999 
A 










9(5) 


> 


1 1 1 B 


3 3 3 3 


3 DD5 


XX 

9 
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Use 



Picture 



Data in Memory 



2. U 
U 
U 
U 
U 



0111000B00 333 3 300DD0005 



3. U 



111 



B 



33 3 33DD5 



4. 



U 



111 



B 



3 3 3 3 



3 D D5 



5. 



U 



999 
A 












9(5) ) 


111B000333330DD5 


XX 

9 













6. 



U 



999 

A 

9(5) 

XX 

9 



00 1 



1 1 B3 



3 3 3 3 ODD 



000 5 



7. 



U 



999 

A 

9(5) 

XX 

9 



111 



B 3 3 3}3 3 D D 



5 



U 
U 



999 
A 














9(5) > 


0111000B000333 3 30DD5 


XX 

9 












. ^,-'' 
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Use 



Picture 



Data in Memory 



9. U 


999^ 
A 

9(5) 
XX 
9 J 












} 011100B3333300DD0005 




U 








OCCURS 




(Cols, 41-44) 



Purpose 

The Occurs columns are used to indicate the number of times an item 
is to be repeated in either the File Section or the Working Storage 
Section. If a number is not supplied, the item is assumed to occur 
only once. 

Conventions 

1 . The Occurs entry must be a decimal integer, starting in 
column 41. 

2. Occurs may be used at any level other than 01. 

3. U elementary items appear within a group which is to be re- 
peated, the complete group will be repeated. Refer to data 
names B and C in the second example shown. 

4. All elementary items which occur more than once must be 
synchronized. 

Examples 

In example 1, the data name to be repeated is an elementary item. 



A 
r 



— - - . 


1 "^ ^ 


T . I r -^ 


1 . ' .4 


. 0,i, 


a: : 'V 



OI'ERATION PARAMETERS 



i 1. 



The storage will be assigned as follows: 



|9,9,0,0|0,9|9,9|0,9,9,9J0 9,9,9[0 9,9,9|0 9,9,9| 



V 



B 



^2 ^3 "^4 ^5 y 



In example 2, the group item is to be repeated. In this case, the items 
within the group must be synchronized. 



OPEr*A --ION 



A. 

8 






OPERATION PARAMETEfJS 



I C T U R E 



..i^ 



!l^=i^__^ 



, a^iui^ 



[ '. o.S_. \R^ 



The storage will be assigned as follows: 



0,0 9,9|0,9,9,9|0|0,9,9|0|9,9,9|0|0,9,9|0,9,9,9[ 



Bl Ci 



Bg Cg Bg Cg 

J ^ J V 



■^1 -^2 '^3 

The group item, A, is repeated three times. 

IDEN (Identification) 



(Cols. 7*7-80) 



Purpose 

The Iden entry associates a card with a source program deck. 

Conventions 

1. Any four characters may be selected by the programmer. 
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2. The Identification is printed on the assembly listing, but is 
not checked by the Macro Assembly Program. 



DATA DIVISION SECTIONS 

FILE SECTION 

The File Section contains the programmer's descriptions of the 
characteristics of the file, which are: 

• to specify the type of processing to be performed on the file. 

• to describe the areas into which the files may be read, or from 
which they may be written. 

• to define the format of the records which are contained in the 
files. 

The File Section begins with a line that contains FILEASECTION in 
columns 8-19. Following this, there must be a description of each 
file that is to be used in the object program. 

Each file description begins with the file name in the Data Name columns 
and an FD entry in the Level columns. Immediately foUowii^ the FD 
will be a set of file parameters that specify the physical characteristics 
of the file, the peripheral unit, and the type of processing to be used 
for this file. A record description will follow the file parameters. 

Example 

The example on the opposite page illustrates the Data Division entries 
necessary to describe a file of time cards to be read by the card 
reader. No file parameter need be sipecified for any file which is not 
referred to by some I/O macro- instruction in this segment. In this 
case the record description immediately follows the FD line. 
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i . ^ ..,..: 


1(^ 


■"■""'""""'""' 


"O (■' E R A T ;:^ -.: '■ .-, u 


...:-"■--■- 


!, , j 


i ■ ■ VTl. ■ 


,. 


2f 




I Fill t-^3X 


C,T 


^l&.f^l ._: 


,_i__ _L ....1....1 ..I. I 1 1 1 




; ■ ' 1 M LS^Ii 


P t v.ilc.E. : 
: ^^ ' i 

J 








i--U.Ui..i_L,^. _^_^ 




( - ; . . . i _ .i _ 


F..N.l).Z,. . _.__^_..^ 


L„ j_ 




=11 


.._..^.__x_.. 


ID A T" .::_ . 
D A 
K R 5 w K D 


-'- ■'--—' ■ 



File Parameters 

File parameters are used to supply input/output information for a file 
to the Macro Assembly Program. A special mnemonic, associated with 
each parameter is written starti:^ in column 17 of tlie form. The 
eni ries which are allowed for each parameter are written in the Opera- 
tion Parameters columns beginning in column 25. The standard set of 
fil" parameters are listed on page 2^, 43; on page 2-44 , the complete 
list of file parameters is given. 

The file parameters supplied for a given file must include DEVICE and 
COMMAND and must be written in the order prescribed in the File 
Parameter list on pages 2-44 through 2-46 . The DEVICE file 
parameter is used to determine which additional parameters are re- 
quired and to establish a standard set of file parameter entry options. 
Any of the standard options can be overriden by supplying file para- 
mi ter name and the desired option. 

Logical device codes are described in the Basic Input/Output System 
write-up under the Logical- Device-to-Physiical- Device Translation 
Table. The logical device number has the following octa!L format: 

XXYY 

wh ere XX is a device type code and YY is the number within this type 
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of the particular device in question. 
following meanings: 



The device type codes have the 



DEVICE Code 



Code (in octal) 


Device 


00 


Typewriter 


01 


Card reader 


02 


Card punch 


03 


Printer 


04 


Magnetic tape 


05 


Disc storage unit 


06 


Macjnetic reader/ sorter 


07 


Perforated tape reader 


10 


Perforated tape punch 



YY might be used for the number of a particular tape unit within a 
magnetic tape subsystem. For example, 0401, 0402, etc. 

If the first characters of the device code are 02 (card punch), no 
additional file parameters are necessary. When the device code is 04 
(magnetic tape), a FILETYPE parameter must be included to indicate 
the input or output option. Finally, if the device code is 01 (card 
reader), 03 (printer), or 04 (where magnetic tape is specified as 
input) an EOFADDR parameter will be required. The following table 
sets forth the required parameters: 



Parameter 



Device 



Magnetic Tape Card Reader Card Punch Printer 
(04) (01) (02) (03) 



DEVICE 
COMMAND 
FILETYPE 
EOFADDR 



Required 
Required 

Required 

Required if 

FILETYPE is 

INPUT 



Required 
Required 

Required 



Required Required 
Required Required 

Required 



The following table specifies the option the Macro Assembly Program 
will assume for File Parameters that are not supplied. 



Magnetic Tape 
04XX 



Card Reader 
OIXX 



Card Punch 
02XX 



Printer 



If this parameter 
is omitted 



The Macro Assembly ProRram will use this set of option s 









AREADEF 


GENERATE 


GENERATE 


GENERATE 


GENERATE 


lOMETHOD 


INCREMENT 


INCREMENT 


INCREMENT 


INCREMENT 


FORMAT 


UNPACKED 


UNPACKED 


UNPACKED 


UNPACKED 


RECFORM 


FS 


F 


F 


F 


RECINDEX 


* 


* 


* 


* 


MODE 


BINARY 


BCD 


BCD 


EDITED 


BUFCOUNT 


2 


2 


3 


2 


EROPTION 
SBOPTION 
RWDLOCK 


HALT 
HALT 
YES 


HALT 
HALT 


HALT 


HALT 


NOT APPLICABLE 




\ 




CLOSERWD 


YES 


\. 




OPENRWD 


YES 






BLKSIZE 


1 




V 


ALTDEV 


Device code 
will be used 




\ 


DENSITY 


HIGH 


NOT APPLICAJM 

\ 


PRIORITY 







\ 


TPMKPROC 


HALT 




\ 


LABELDEF 


NONE 




\ 














\ 
\ 
\ 
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If the programmer specifies AREADEF DEFINED, he must also expli- 
citly supply and specify values for DCWUST, BLKDWNO, RECDCWNO 
and RECLNGTH. 

A complete list of the file parameters and a detailed description of 
their optional entries is included in the Extended Input/Output System 
(EIOS) write-up. For readers' convenience, the file parameters are 
listed below with all of their option entries. 



File Parameter 



AREADEF 



Ol jtion Entry 

GENERATE [jref sym ] 

DEFINED 

REMOTE 



DEVICE 

COMMAND 

lOMETHOD 



NNNN 



xxxx 



INCREMENT 

EXCHANGE 

SHARE 



FORMAT 



CONTIGUOUS 

UNPACKED 

SCATTERED 



RECFORM 



F 
FS 
V 
VS 



RECINDEX 



X 



FILE TYPE 



INPUT 
OUTPUT 



MODE 



BINARY 

BCD 

MIXED 

EDITED 

UNEDITED 



DCWUST 



refsym 
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File Parameter 
BUFCOUNT 
RECDCWNO 
EROPTION 



RDBLKEXT 

EOFADDR 

SBOPTION 



Opti o n Entry 

NNN 

NNl^I 

DUMP 

TYPE 

RETRY 

HALT 

refsym 

refsym 

refsym 



DUI^P 
HALT 
refsym 

The following are needed only for a magnetic tape file: 

CHECKPOIN:r 



EORCHKPT 
RWDLOCK 

CLOSERWD 

OPENRWD 

BLKSIZE 
ALTDEV 
RECLNGTH 
DENSITY 

BLKDCWNO 

PRIORITY 

EOREXIT 



YES 
NO 

YES 
NO 

YES 
NO 

NNNNN 

NNNN 

NNN 

LOW 
HIGH 

NN^[ 

N 
refsym 
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File Parameter 



TPMKPROC 



LABELDEF 



Option Entry 

HALT 
IGNORE 

refsym 

NONE 
STANDARD 

refsym 



I/O Buffer Area Definition 

In the Macro Assembly Program, the programmer may indicate whether 
the buffer area(s) and DCW list(s) are to be generated by the pr<Dgram, 
supplied by the programmer in this segment, or have been supplied in 
a separate segment. 

The AREADEF file parameter is used to indicate which of the 0])tions 
is desired. This parameter has the following format: 



One or more of the following is needed only when LABELDEF is 
STANDARD 



LABELOPT 
LABELXTS 

LABELCON 



XXXX 

Exit 1 address; Exit 2 address; 
Exit 3 address; Exit 4 address 

ZZZZNNNNFILENAMEISSSYDDDXXXXFFFF 



AREADEF 



The options are defined below: 



/ GENERATE L;ref symbol ] 
< DEFINED 
1^^ REMOTE 



GENERATE 



A list of File Parameter options for perforated tape, disc storage 
units, and magnetic reader/sorter will be specified later. 

Re cord Description 

A description of the logical record(s) to be found in the file must be 
included immediately following the file parameters. 

Inherent in the structure of logical records is the concept of levels of 

data. The programmer writing in a field-oriented language will find 

it convenient to divide the items of data in the record into groups, and 

to possibly further sub-divide the items of data within these groups. 

This is made possible by assigning numeric levels to each item of 

data within the record. Data described in a Macro Assembly Source Program 

may be assigned levels 1 through 4. Using level 1 for a record name, 

it is then possible to group data within the record into three levels 

subordinate to the record level. 

For additional details on record structure, refer to Concept of Levels, 
page 2-23. The remaining columns Type, Data Name, Sync, Use, 

Picture, and Occurs must be filled in as necessary. For specific 
details about allowable entries and formats, refer to the particular 
entry description. 



ref symbol 



DEFINED 



The Macro Assembly Program will generate 
the buffer area(s), DCW list(s), and the 
file table from information supplied by the 
file parameters. This option will be used 
if the AREADEF pai-ameter is omitted. If 
the lOMETHOD option is SHARE, or if the 
FORMAT option is SCATTERED, the GEN- 
ERATE option cannot be used. 

This is an optional entry which, if specified, 
will cause the program to assign the speci- 
fied Reference Symbol to the first word of 
the first buffer area generated for this 
file. 

The programmer must allocate the area(s) 
required for buffer(s). The DCW's and BSS 
pseudo-operations used to reserve the area 
must be written in tlie Procedure Division. 
The Macro Assembly Program will generatu 
the file table as defined by the file piara- 
meters. 
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REMOTE 



This indicates that the file parameters and 
record description are for reference only in 
this assembly. Memory will not be allocated 
for the file table, DCW list(s), and buffer 
area(s). The buffer area(s) for this file must 
have been established in a separate segment. 



FILE SECTION CONVENTIONS 

The following conventions apply to files or logical records defined in 
the File Section: 

1. The file name supplied with the FD parameter will be assigned 
to the first word of the file table generated for this file. 

2. All data items described within a logical record are assigned 
addresses relative to the beginning of the record. Therefore, 
reference to a given item within the record must be indexed. 
The first word of the record will be assigned the relative 
location 0. During the execution of the object program, the REC- 
INDEX will coitain the bcation of the first word of the current 
logical record. Any reference by a macro- instruction to a 
data item defined in the File Section is automatically modified 

by the index word (RECINDEX) assigned to the file. 

3. If any macro- instruction refers to a data item within a logical 
record, that item must be described in the Data Division. 

4. If a data item within the record has not been described, all 
references to that item must be written in the basic assembly 
language. The references should be relative to the start of 
the record and must be indexed. For example, if the following 
record was described with a single entry at the 01 level, 



PAY- NO ORG 



DATE 



the following basic assembly language instructions would be 
required to unpack the record to Working Storage. Assume 
that fixed index word 4 has been assigned to the file. 
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Operation 


Operation Parameters 


LDD 


1, 4 


SRDA 


3 


STD 


PAY NO 


LDD 


2, 4 


SRDA 


3 


STS 


ORG 


LDD 


3,4 


SLDA 


1 


SRDA 


2 


STD 


DATE 



7. 



8. 



Each buffer area generated by the Macro Assembly Program 
will begin at a mod 4 location. The generated buffer^)will 
overlay the loader program at object time. 

For efficiency, if a packed data item is to be used several 
times, it should be unpacked by moving it to a synchronized 
data item in the Working Storage Section. Subsequent references 
should then be made to the unpacked item. 

The length of a logical record described in the File Section 
should be a multiple of four characters. ]I the record is not 
a multiple of four characters, the FORMAT file parameter 
must specify UNPACKED and at least one data item within 
the record must contain a U in the Use column, 

It CONTIGUOUS is specified in the FORMAT file parameter, 
it will override any U written in the Use column. 

If UNPACKED is specified in the FORMAT file parameter, the 
RECFORM must be F or FS, and a complete logical record 
description must be supplied. One entry is necessary for 
each field to be unpacked. 



WORKING STORAGE SECTION 

The programmer uses the Working Storag;e Section as follows: 

• to describe areas to be used for intermediate input/output 
processing 

• to build constants 
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• to define intermediate storage to be used as tables, work areas, and 
temporary storage during execution of the object program 

• to describe format lines with initial values to be used for output 
records and print lines 

The first line in this section must contain WORiONGASTORAGEASECTION 
in columns 8-30. This will be followed by the entries required to des- 
cribe the constants and data storage required by the source program. 

Data items defined in Working Storage may be either unrelated elemen- 
tary items or logical groups. The first entry to appear in the level 
columns must be an 01 (or 1). If the entries are unrelated, this will be 
followed by another 01 level. If it is followed by a level number higher 
than level 01, the 01 level data item is a logical group. The group may 
be further subdivided as indicated in Concept of Levels, page 2-23. 

The following entries may be used to describe the data items: 

Data Name 

Sync 

Use 

Picture 

Occurs 

Value 



WORKING STOPIAGE SECTION CONVENTIONS 

The following conventions apply to items described in the Working 
Storage Section: 

1. Data items described in the Working Storage Section will be 
assigned specific addresses. Therefore, reference to items 
within this section need not be indexed. Indexing may be 
used to address items used in a table. 

2. The number of words moved to or from the Working Storage 
Section with either a RE ADA TO or WRITE A FROM option is 
equal to the size of the input or output record. 

3. Unrelated numeric items in the Working Storage Section should 
be right synchronized to produce more efficient object coding. 



2-50 



12/6/63 



4. If an initial value is not specified, the initial content ol the 
item is xu^redictable. 

5. The only pseudo-operations allowed in the Working Storage 
Section are DGR, DGRR, and DGRE. (See Common Data 
Areas, page 2-101.) 

Example 

The following example illustrates a few of the various types of storage 
areas, constants and print lines that may be described in the Working 
Storage Section. 



L K.IS.L.JJ 1 
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c.i. 
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,D 1 
. i. 
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H ft. i i^' K D 

I p I, p .( ; 


; 1 

. ,1 


^ 


%'i , .. . 

<!.'?. ... 

q 1 1 1 V 1.? . . 
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MEMORY ALLOCATION 

Data described in the Macro Assembly Program Data Division is assigned 
memory positions, proceeding from left to right. If synchronization is 
not specified, consecutive data items are assigned adjacent character 
positions. 

The following Data Division entries 



REF-EREHNCi; SYMBOL 


O o K R A 


T10N 


OPERAT[ON PARAMETERS 


DATA NAME 


^:> 


5 
C 


i2 




2il 


PIC T U R Fl 
36 




X. 


- 


- 










S. =!,<=) , 










A,( , T.ii , , 















will be assigned storage as indicated below: 

+ 

J9 9 9 9|9 A A AJAA A A | 

A B C 

When synchronization (R or L in the Sync column) is specified, the 
Macro Assembly Program insures that the item is placed into an integral 
number of words. This may be illustrated by modifyir^ the first example 
to include an R in the Sync columns of data item B. This is shown in 
the following example. 

The following Data Division entries 



X . 
1 _. 




— 




^ J. - ' -j',. .: 
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will result in the following assignment: 



9 9 9 OJO 0,9 9|A,A A AlA A A,0| 
ABC 



Note that data item B is unpacked in an integral number of words and 
that the assignment of positions to item C started at tlie first character 
position of the word following the synchronized item. This would apply 
even if item B included L in Sync rather than R: 



i 9, 9, 9, 0|9, 9, 0.0| A A A, A| A A A 0| 

A B C 

Whenever the Macro Assembly Program encounters an 01 level, it will 
start assigning positions in the first character position of the next word. 
This is illustrated in the example below. 

For the following Data Division entries 



R !.- 1- f: R E M C F SYMBOL 


OPERA 


TIO N 


OPE FAT to N PARAMETERS 


DATA NAME. 
' 16 


^^ -■-^■■■^^ 


;;■} 


5 
C 


tz 


E 


24 


P,CTUR,. 


ft-J ---1. L _..J L. I_ __1 


...0.L 


-- 










5jJ_^ ^ ^ ^ 




0,1 










■?,r 


c._.. ._^^____^ 




0,1 




H 








'^,«} , , , , 


j_ i 1 1 . 1 





































memory will be assigned as follows: 

|9,9.0.0|9,9,0.0|0, 0.9,9 1 
A B C 
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In the following examples, the data, as it appears on external media is 
shown first, followed by the way it is desired to nave it appear in mem- 
ory. The coding used to arrange for this memory allocation is given 
last. 



Exanyles 



Data on the 
external media: 






^f' 






s^ 



111B33333DD5 



Si' 



Data in memory: |l 1 1 BjS 3 3 3|3 D D 5 



Coding: 





REP'ERENCE SYMBOL 


D ^ r ■( A TION 
1 


DPEHATrON PARAMETERS 




DATA NAME 
, IB 


1.^ V rL 


^0 


s 

Y 
C 


?.2 




24 


2« 


PIC TU R F 






_^ (^1 1 














, , 














9,? ,1 


1 ,11.11.1 




Qii I 










A. , 







F,T ,f , ! .T).-^,7,, 


1 ajz 










9,C ,5 


.? ...^• 




F r,f:,U.O,~,H, 


_ f).i^ 


^.. 










X,X, 






r X f 1 , r> , — , 5 , 


iiii 










9, , 


, , 






1 
1 i- i J 






, 




\ — 1 — 


1 1 1 1 ' ' ' 



Data on the 
external media: 



111B33333DD5 






Data in memory: 



1 1 IJO b{0 3|3 3 3 3 



00 DD 



5 



Coding: 



L&.r E..-.J-,D.'^-r^:i-- 



ir.J,-.£.^,Llii-l 



.i1_. 



?f:,J_.[-..Li-.^-5- 



"^ ' 1 




— 


L 1 i 




1 i , L_ . 


-V -> 3 


-J- — 


9. '=?,'? 




1 I . . 


X ^ ' """ \ 


Pi' ' 






'^ '■ 'i 







^, C,5 


), 




'" 1 ( 


u 




Xiy 1 






*^ ;^ ^ 


IJ 




^' . 




i . . 


^ ' r r 








, 


- S" 


1 
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3. Data on the 
external media: 

Data in memory: 

Coding: 



>, jo 

^^' «" ^1 -c ^^ 

0111000B0003333300DDCI005 



/ 









i 



111 



000B00033333 



00 DD 



00 5 



REFERENCE SYMBOL 


OPERATION 

1 


OPERA no N PARAMETERS 


DATA NAME 
9 16 


17 


LEVEL 
18 19 


zo 


5 

c 


22 


E 


24 


p r C T U R E 


R.£,C,?.,R,D. , 




hC^X. 
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II 1 
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f .[ ,£ L ,r!,-,2 : 


' 1 O. 1 
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1 1 1 . 1 
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Data on the 
external media: 

Data In memory: 

Coding: 
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Vn. PROCEDURE DIVISION 



The Procedure Division is that portion of the source program in which 
the programmer writes the operations that process the data and control 
the program flow. In the Macro Assembly Program, these operations 
may be written as macro- instructions or basic assembly language symbol- 
ic instructions and pseudo- operations. 

The Macro Assembly Program will process all basic assembly language 
symbolic instructions and pseudo- operations which are written in the 
Procedure Division. For a complete description of the instruction for- 
mats, Operation Parameter entries, and a listing of the GE- 425/435 
Instruction Repertoire, as well as a description of all pseudo- operations, 
refer to the Basic Assembly Language section. 

Macro- instructions allow the programmer to specify the operation to be 
performed rather than supplying the detailed coding. A description of 
the function, mnemonic operation code, and operation parameter format 
for each macro- instruction available!- in the Macro Assembly Program 
will follow a discussion on the Procedure Division entries and use of 
the Operation Parameters. 



WRITING THE PROCEDURE DIVISION 

The Procedure Division is the fourth division to be written on the 
GE-425/435 Macro Assembly Program Programming form. The first 
line of this division must contain PROCEDUREADIVISION in columns 
8-25. This is followed by the macro- instructions, symbolic instructions, 
and pseudo- operations which describe the flow of the program. Finally, 
the division must be terminated by a line that contains END or TCD in 
the Operation columns. 

Comment lines denoted by an * in column 7, may be interspersed through- 
out the Procedure Division. 

Since the same programming form is used for the Data Division, it con- 
tains two sets of columnar headings. The headings that pertain to the 
Procedure Division are discussed in the next several paragraphs. 
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SEQUENCE 



(Cols. 1-6) 



P urpose 

The sequence number is provided to aid in maintaining the correct order 
of the source program deck. 

A ssembler Action 

If the sequence check option is indicated in the Lanfjuage Processor option 
card, the sequence number assigned by the programme:' will be checked 
using the GE-425/435 collating sequence. Any source program card with 
a sequence number equal to, or less than, the preceding card, will be 
flagged as a possible error on the program listing. 



TYPE 



(Col. .7) 



P urpose 

This column is used to indicate the use of the line in whiich it appears. 
Tiie entries which may be used are: 

* denoting a comment line. The comment line is written on the 
final listing for program documentation. Thei'e is no restric- 
tion on the number of comment J.ines that may be included. 

C denoting a continuation of the Operation Parameters columns. 
If a list of parameters required by a macro- iristruction is 
larger than the Operation Parameters columns, the list may 
be continued on the following line. The continuation of the 
parameter list must begin in column 25. The Reference Symbol 
and the Operation code should not be repeated on the continua- 
tion line. The last parameter (literal, data, niune, reference 
symbol, or file name) must not be split between the two cards 
The line to be continued must terminate with ai comma or a 
semicolon. 
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Example 
Type 



Ref .Sym. 



Operation 



Operation Parameters 



GOTO refsym-l;refsym-2; . . .refsyro~8, 

C refsyTiv~9 DEPENDING^ON TCJIO 

GOTO re£syin~l ; ;DEPENDINGaON TtUNO, 

C X8 

* THE FOLLOWING EXAMPLE IS INCORRECT: 

GOTO refsyin~l;refsyin^; ref 

C sym^ DEPENDING^ON TCp-NO 

Note: The refsym cannot be split between lines. 



REFERENCE SYMBOL 



(Cols. 9-16) 



K a Reference Symbol is written in a macro-instruction, the symbol will 
be attached to the first instruction produced by the macro- generator. 



OPERATION 



(Cols. 17-24:) 



Purpose 

The operation is a mnemonic code which represents a macro-instruction, 
machine instruction, or a pseudo- operation. 

Conventions 



1. The operation may be written anywhere within the Operation 
columns. 

2. The mnemonic operation code must not contain imbedded 
blanks. 



Purpose 

The Reference Symbol enables the programmer to assign symbols 

to instructions and pseudo- operations written in the Procedure Division. 

Conventions 



OPERATION PARAMETERS 



(Cols. 25-76) 



The symbolic Reference Symbol entered in columns 8-16 must follow 
these conventions. Reference Symbols -- 

1. may be one to eight characters in length 

2. may be formed from the alphabetic characters A-Z, the numer- 
ics 0-9, and the tilde, written ^ 

3. may be defined only once in a segment 

4. must contain at least one alphabetic character 

5. may be floated anywhere within the eight column field 

6. must not contain imbedded blanks. 



Purpose 

The parameters necessary to complete the function indicated by the Op- 
eration are written in the Operation Parameters columns. 



Conventions 

1. Parameters written in the Operation Parameters columns must 
begin in column 25. 

2. If the Operation code specifies a basic assembly language symbolic 
instruction or pseudo- operation, the parameter may be a reference 
symbol, a data name, an absolute address, an expression, a 
literal, or a value. The Operation Parameters columns o): basic 
assembly operations may not contain imbedded blanks. The for- 
mat of these basic instructions and of the pseudo- operations is 
described in the Basic Assembly Langijage section of this manual. 
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With a macro- instruction, a parameter may be a reference 
symbol, a data name, a file name, a literal, an expression, 
or an absolute value, depending on the specific Operation being 
usod. The parameters follow the rules set forth in Use of Op- 
eration Parameters. 

Any address modification will appear in the Operation Parameters 
columns. 

Comments may be included in the Operation Parameters columns, 
providing that at least two blanks separate the comments from the 
last parameter on the line. 

The normal delimiter is a semicolon, however, in the description 
of each macro- instruction it is specifically stated what the de- 
limiters are. 



IDEN (Identification) 



(Cols. 77-80) 



Purpose 

These columns are used to associate a card with a source program deck. 

C onventions 

1. Any four characters may be selected by che programmer. 

2. The Identification is printed on the assembly listing but is not 
checked by the Macro Assembly Program. 



Refer ence Symbol 

Reference Symbols may be assigned to macro- instructions, basic assem- 
bly language instructions, and pseudo- operations defined in the Procedure 
Division. 

W;ien a Reference Symbol is used as a parameter in a macro- instruction, 
it may use address modification as specified in Macro- Instruction Address 
M idification, page 2-64.- 

A Reference Symbol used in a basic assembly language instruction or 
pseudo-operation may be part of an expression as described in Calculated 
E ilries. page 1-16 of the Basic Assembly Language section. 

D,j.ia J>Iame 

Dill a names are associated with data items and records described in the 
Data Division. Any reference by a macro -instruction to a data item 
described in the File Section is automaiically modified by the index word 
(RECINDEX) assigned to the file unless a specified index is supplied. 

If a macro-instruction references a data name, the description of the 
item is used to generate the instructions specified by the operation; 
address modification may be indicated as described in Macro-Instruction 
Address Modification, page 2-64. 

When a basic assembly language instruction or pseudo- operation refers 
directly to data defined in the Data Division, the Macro Assembly Pro- 
gr jui provides tlie address of the word which contains the least significant 
ch u'acter of the data. AnexpresKioii and index may be specified for 
aci tress modification. 

File Name 



USE OF OPERATION PARAMETERS 

The number and types of parameters vary depending on the operation 
code. The description of the specific macro- instructions indicate which 
type, or combination of types, may be used as parameters. 

The following parameter types may be used in either macro- instructions 
or basic assembly language instructions in the Procedure Division. 



Ti c file naine is defined with an FD entry in the File; Section of the Data 
Division. Wlien a file name is referenced by a macro- instruction it 
sp 'ciiies which file is to be operated upon; no address modification may 
be indicated. 

If he file name is referenced by a basic assembly language instruction, 
till Macro Assembly Program will provide the address of the first word 
of !he file table. Any word within the file table may be referenced by 
pL.cing a data name on the file parameter entry or an increment may be 
ap )eiided to the file name to address entries within the file table. 
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Literal Entries 

A literal specifies the actual value of data to be operated on by a macro- 
instruction. Literals are stored as unpacked values, synchronized left 
or right depending on their use in the instruction. If a literal with the 
same value and alignment has been previously defined, the assembler 
uses the address of the original literal. 

The literals described below are for use with macro- instructions only. 
For a description of the basic assembly language literals, refer to 
Literals, page 1-21 of the Basic Assembly Lai^uage section. 

Two types of literals may be used in macro- instructions: numeric and 
non-numeric. 

• Numeric Literals --A numeric literal may contain the numbers 
0-9, the decimal point (.), the leading plus sign, (+), or the leading 
minus sign (-). A decimal point may be included anywhere within 
the numeric literal except as the right hand character. The decimal 
point will be treated as an implied decimal point by the assembler. 
A numeric literal may contain only one decimal point and/or one 
sign. 

Examples 

13602 

3 

1.2 

-3.9 

+4235.06 

The length of a numeric literal may be from 1- 16 characters not 
including the sign and/or decimal point. The sign, if included, is 
carried internally in the standard sign position. It is not established 
as a separate character. 

Non-Numeric Literals -- Non-numeric literals must be enclosed by 
quotation marks. 

An alphanumeric literal consists of any combination of characters in 
the GE-425/435 character set, except the quotation mark. An alpha- 
betic literal consists entirely of alphabetic and blank characters. A 
non- numeric literal may be from one to forty characters in length and 
must not be split between two lines. 
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Examples 

"%NET-PAY" 

" END OF JOB" 

"TOTAL TAX" 

"-16.83" 

The "-16. 83" is considered an alphanumeric literal because it is 
enclosed in quotation marks. It is carried internally as 

-16.83 

and therefore may not be used in calculations. 

If -16. 83 is needed in an arithmetic operation, it is entered as a 
numeric literal (without quotation marks) and is carried internally 
in one word as 

1683 

Absolute Entries 

If a specific macro- instruction allows, a parameter may be a decimal 
integer. This may specify either a fixed index word or a control count. 
If used with a basic assembly language instruction, it may refer to any 
fixed machine location or value. 

Macro-Instruction Address Modification 

• Using jndexes --An index may be specified as a modifier to a data 
name or a reference symbol used in the Operation Parameters of 
a macro- instruction. The index may be a fixed index word or a 
reference symbol and must immediately follow the data name or 
reference symbol. The index is separated from the data name by 
a comma. As many as three indexes may be specified, separated 
by commas. Literals may not be indexed. If any index is specified 
in a macro- instruction, the specified index overrides the index 
assigned to the file. If a data name which was described in the File 
Section requires any index other than the index assigned to the file, 
all necessary indexes (including the file's RECINDEX) must be 
specified following the data name. 
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Examples 

Operation 

GOTO 

LOAD 

LOAD 

MOVE 



Operation Parameters 



refsym , 4 

data- name- 1, ABLE 

data- name- 1, ABLE, BAKER, 6 

data-name-1, 4;data-name-2, 4 



Using Calcualted Addresses -- In macro- instructions, simple ex- 
pression may be formed by following the reference symbol parameters 
with an arithmetic operation (+ or -) and a decimal integer. 

It is difficult to predetermine the number of instructions that will be 
generated by a macro-instruction. Therefore, calculated addresses 
(i. e. , *+2 or refsym-3) should never be used to refer past a macro- 
instruction. 



MACRO-INSTRUCTION DESCRIPTIONS 

Macro Assembly Source Language functions include 

Input/ output 

Data movement 

Procedure control 

Arithmetic operations. 

Descriptions and usage of each of the macro-instructions in these four 
categories are presented in this chapter. An alphabetic list of all macro- 
instructions is given in Table A at the end of this section of the manual. 

Use of Hardware by Generated Coding 

During execution of the object coding produced by a macro-instruction, 
the contents of location and the fixed index words 1, 2, 3, and 6 plus 
the hardware accumulator words 12 through 15 may be destroyed. This 
is sometimes necessary to produce the most efficient object coding. 
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Therefore, prior to using a macro-instruction, the programmer must 
make the following provisions : 

1. Insure that the accumulator is located at OS. 

2. Save the contents of location 0, 1, 2, 3, 6, imd 12 through 15 
if the contents will be needed following execution of the macro- 
instruction. 

The use of the comparison indicatoES will be indicated in the description 
of the macro- instructions that may mo<3ify their s,ettings. 

Operation Parameters Format Notation 

The notation shown in the chart below is used to describe the variable 
format of the Operation Parameters columns. 



Operands 



data-name- ' 



file-name- 



refsym- 



literal 



Choices 



Options 



indicated by lower case. words. They 
indicate the type of operands that a 
programmer may use. 

associated witii an entry in liie Data 
Division. 

defined with an FD entry in the File 
Section of the Data Division, 

associated wilJi an instruction or 
pseudo-operation in the Procedure 
Division. 

the literal must be specified as des- 
cribed in Literal Entries, page 



are enclosed in braces 
must be selected from t 
in a set of braces. 



f "\ . One entry 
those shown with 



are enclosed in brackets f 1. Information 
contained within the brackets may be in- 
cluded or omitted. 
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KEY WORDS 



NOISE WORDS 



A's 



are those which must be used in a macro- 
instruction. They are indicated by under- 
lined upper case words. 

are those which may be used to clarify 
(in English language) the meaning of a 
macro-instruction on the programming 
form. When used, they must be correct- 
ly spelled. Tiey are indicated by upper 
case words. 

are indicated in the macro- instruction 
formats and must be included on the 
programming form. 



INPUT/OUTPUT OPERATIONS 

In the Macro Assembly Program, the programmer may include any of 
tlie logical record macro- instructions and service macros made aivail- 
able by the Extended Input/Output System. For a general discussion of 
the design objectives and operating philosophy (including label processing 
and error recovery procedures) refer to the Extended Input/ Output System 
write-up. 

To incorporate the Input/Output macros in a Macro Assembly Program, 
the programmer must also provide 

1. a description of each file to be used by the macro-instructions. 
These files are defined in the File Section of the Data Division. 

2. a list of the major input/ output control routines to be included 
with this segment. The routines are defined witli System De- 
finition Parameters in the Environment Division. 

A description of Input/ Output macro- instructions follows. 



READ 


Function: 


To obtain the next logical record from an input file. 


Format: 








Operation 


Operation Parameters 


Option 1. 


READ 


file- name- 1 


Option 2. 


READ 


1ArT^r^A fdata-name-ll 
file-name-lATOA ' \ 



Notes : 



1. In Option 1, READ causes the location of the first word of the 
next logical record to be placed in the specified RECINDEX. 
The records may then be processed in the input buffer by using 
RECINDEX to modify all references to the logical record. 
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2. In Option 2, READ causes the location of the first word of the 
next logical record to be placed in the specified RECINDEX 
and, in addition moves the record into working storage or an 
output file buffer area. The second parameter may specify the 
reference symbol of a work area defined \Cith a BSS in the Pro- 
cedure Division, the data name of a logical record defined in 
the Working Storage Section, or a file name. The length of the 
record in file-name- 1 determines the number of words to be 
moved. 

3. The data record last accessed by a READ macro continues to be 
available in the input buffer via RECINDEX until the next READ 
for that file has been issued. However, once the current input 
data record has been released to an output file by a WRITE 
macro, further modification of the record in the input file will 
not be reflected in the output record. If the current input record 
has been released to an output file by a WRITEX macro, any 
further modification of tlie record in the input area, up to the 
point that another WRITE or WRITEX is given to the same out- 
put file, will be reflected in the output record. 

4. Once a record has been obtained by a READ file-name, it cannot 
be moved to Working Storage by a READ file-name TO refsym, 
since the latter macro will access the next data record instead 
of the record desired. 

5. The contents of RECINDEX must not be changed by the object 
program. 

6. An OPEN macro-instruction for the file must have been executed 
before executing the first READ macro- instruction for the file. 



WRITE 



PHinction: To release a record to an output file. 
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For mat; 

Operation 

Option 1. WRITE 

Option 2. WRITE 

Nones: 



Operation Parameter s 

Trefsym "^ 

file-name- 1 FROM / data-name ' 

|file-name-2J 

file-name- 1 



1. In Option 1, the WRITE macro- instruction moves the data record 
into the next available space in the current buffej* area of file- 
nanie-1. The second parameter specifies the source of the data 
record to be moved to the output file buffer. The; parameter may 
specify the reference symbol of a work area defined with a BSS 
in the Procedure Division, the data name of a logical record in 
the Working Storage Section, or the file name of an input file 
whose current record is to be moved. The progi'ammer must 
insure that the source record conforms with the record format 
specified in the output file. If the output file is composed of F 
or FSl form records, the length is specified in thie RECLNGTH 
entry in the file table. For V or VS"^ records, tlie length will 

be indicated in the record length word of the record to be moved. 

The RECINDEX assigned to the file always references the first 
word of the last record placed in the current output buffer. The 
record remains available for processing in. the output buffer 
via the RECINDEX until the next WRITE or WRITEX is issued 
for this file. 

2. For Option 2, the WRITE macro-instruction involves no data 
movement by the Extended Input/Output System. It is a request 
for the next available space in the current buffer for file-name- 1, 
in which the object program may build an output record. The 
location of the first word of the space made available will be in 



NoteT7i)F -- Fixed- Leneth Records. FS -- Fixed Lengthi Record with Block 
Serial Number, ^y -- Variable-Length Records. VS -- Variable- 
Length Records with Block Serial Number. 
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the named file's RECINDEX. The size of the space made avail- 
able is determined by the contents of the RECLNGTH entry in the 
file table, for both fixed and variable length records. For V or 
VS, the programmer must set RECLNGTH in the file table to 
the desired value before giving the WRITE. 

In contrast to the normal method of placing records in an out- 
put file with the first form of the WRITE macro-instruction 
(after processing of the record is completed), WRITE file-name-1 
must be issued before data is moved to the output area. This is 
to insure the proper allocation of space and to avoid loss of data. 
The programmer must be careful with this form of the WRITE 
macro- instruction to avoid issuing a WRITE after the last out- 
put record of the file has been placed in the output area; a 
WRITE at this time would reserve an extra record space, resulting ir 
an additional output record of unknown content. Both forms of 
the WRITE macro-instruction may be used within a program to 
place records in the same output file. However, if both WRITE 
and WRITUX macro- instructions are used with the same output 
file, the file parameter lOMETHOD must specify EXCHANGE. 

3. The contents of RECINDEX must not be modified by the object 
program. 

4. An OPEN macro-instruction must have been executed for this 
file before the first WRITE is issued for the file. 



Notes: 



1. 



2. 



3. 

4. 



The lOMETHOD indicated for file-name-1 and file-name-2, 
must be EXCHANGE. 

A data record can be released to only one file by the WRITEX 
macro- instruction. If the user desires to place the same 
data in more than one file, the WRITEX macro-instruction 
may only be used for one of the files. The records must be 
physically moved into the other files ' y the WRITE macro- 
instruction. 

The WRITEX macro may only be used With form F or FS records. 

An OPEN macro must be executed for this file before the first 
WRITEX is issued for this file. 



(See the GE-425/435 Extended Input/ Output System Reference Manual 
for details of WRITEX. ) 



OPEN 



Function: To ready an input or output file for processing by Input/ 

Output macro-instructions. 



WRITEX 



Function: 



Format: 



To release a record without internal movement of the data 
record. 



Operation Operation Parameters 

WRITEX file-name-lAFROM4file-name-2 



Format: 



Notes: 



Operation Operation Parameters 

OPEN file-name-l;file-name-2; .... ;file-name-n 



1. An OPEN macro-instruction must be executed for a file before 
any Input/Output macro-instruction is processed for that file. 

2. This macro-instruction produces a call to the OPEN Subroutine 
to ready the named files for processing. The Operation Para- 
meters specify the file-names of all files to be opened at this 
time. 
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3. 



The OPEN subroutine performs all necessary functions such as 
initial rewind and header label processing of tape files. This 
subroutine establishes the proper linkage and controls necessary 
for the proper functioning of the Logical Record Macro Routines, 
Buffer Control Routines, and the Scheduling System. 



CLOSE 



Function: To terminate the processing of input and output files. 

Format: 



Notes: 



Operation Operation Param eters 

CLOSE file-name-l;file-name-2;. . . . ;file-name-n 



1. A CLOSE macro-instruction should be issued after completing 
the logical processing of one or more files. 

2. The macro-instruction produces a call to the CLOSE Subroutine. 

3. The "closing" of a file allows the Extended Input/ Output System 
to write out any remaining blocks or partial blocks of records, 
to perform designated trailer label processing of output files, 
and to perform designated rewind procedures for both input and 
output files. Tlie closing of a file removes it from the "active" 
list, and disengages it from the Scheduling System. 

4. Files may be closed individually, or all at once. One advantage 
to closing the files as soon as their processing is completed is 
to allow the operator to stagger the physical work necessary to 
remove that file from the computer system, thereby reducing 
the time between jobs. 

5. The user must avoid issuing any macro- instruction naming a 
closed file, as the propa- linkage and controls are not established. 
If this situation occurs, the Extended Input/ Output System types 
an error message and halts the program. 
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TYPE 



Function: To perform requested typewriter Input/ Output operations. 

Format: 



Motes: 



1. 



2. 



Operation 
TYPE 



Operation Parameters 



(input "1 TaLPHaI rrefsym,N'] 
) OUTPUTf ]OCTAL(' jdata-namer 












If a reference symbol is indicated, it must be assigned to a 
DCWC which points to the word containing the first character 
of the message to be typed. The number of DCWC's in the list 
beginning at refsym is specified by N. The DCWC's must be 
written by the programmer in the Procedure Division. 

If the third parameter specifies a data-name, i;he Macro Assem- 
bly Program builds the required DCWC. The size of the field 
defined by data-name determines the number of characters to 
be typed. 



EXTENDED INPUT/ OUTPUT SYSTEM SERVICE MACRO- INSTRUCTIONS 



F'inction: 



F irmat: 



To provide the logical software equivalents of peripheral 
hardware functions necessary to maintain the logical 
environment established by the Extended Input/Output 
System. 

The following Service Macro-Instructions may be used 
in the source program: 
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Operation 
BKSPTM * 
RELEASE 
FDSPTM * 
BKSPNBLK * 
REMIND * 
WRITETM * 
FORCE * 
RD LABEL 
WRLABEL 
CHKPT 



Operation Parameters (Meaning) 

file-name- 1 [; (character)] (Backspace to tape mark) 

file-name- 1 

file-name-l[ ; (character)] (Forward space to tape mark) 

file-name-l;N (Backspace N blocks) 

file-name-1 

file-name-l[; (character)] (Write tape mark) 

file-name-1 

file-name- l AlNTOA refsvm;N 

file-name-l AFROMfl refsym;N 



For a complete description of the Service Macro- Instructions listed 
above, refer to the Extended Input/Output System write-up. 



* Precede with a RELEASE macro-instruction. 
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DATA MOVEMENT 



MOVE 



Function: 



Format: 



To transfer data from one item to another conforming to 
the description of the receiving item. The receiving field 
picture determines the format of the data. 



Notes: 



Operation 
MOVE 



Operation Parameters 

fdata-name-l 1 
[^literal 



data-name-2 



1. K the receiving field is non-numeric (alphabetic or alphanumeric), 
data is transferred left-justified with space fill or truncation 
provided at the low order end as required. 

2. If data is transferred to a numeric area, MOVE automatically 
aligns decimal point position and provides truncation or 2,ero fill 
at either, or both ends as required. If the decimal point position 
is not supplied, the data is right justified in the receiving area. 

3. If the description of the receiving area specifies editing, move- 
ment of data takes place as described above, the data is edited 
according to the image of the receiving area (refer to Picture, 
page 2-24). 

4. If an numeric area is being moved to a data item defined as an 
index, conversion from decimal to binary is performed; data 
being moved from an index to a numeric item is converted fron: 
binary to decimal. 

5. The contents of data-name- 1 are not disturbed. 

6. Table-1 indicates the types of moves lh;it can be performed on 
elementary items by the MOVE macro-instruction. Aji entry in 
the table indicates a valid MOVE; the number in parentheses 
gives the number of an example in Table-2 that shows the content 
of the receiving field after the move. 
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Table 2. Content of the Receiving Field alter MOVE 



Table 1. Types of moves Performed on Elementary Items by MOVE 



-~— ^MOVE CO data-name- 2 
MOVE from data-name- 1 ^ ~~~~ — 


Numeri c- 

As suraed 

Decimal 

Point 


Numeric- 
Integer 


Numeric- 
Edited 


Alpha- 
numeric 


Alpha- 
numeric 
Edited 


Alpha- 
betic 


Numeric-Assumed Decimal Point 


(1) 


(2) 


(3) 








Nunieric- Integer 


(4) 


(5) 


(6) 


(7) 


(8) 




Numeric -Edited 








(9) 


(10) 




Alphanumeric 


(U)* 


(12)* 


(13)* 


(14) 


(15) 


(16) 


Alphanumeric -Edited 








(17) 


(18) 


(19) 


Alphabetic 








(20) 


(21) 


(22) 



♦ The contents of the field being moved must be a positive numeric integer. 



If any MOVE is attempted that is not indicated by an entry in Table- 1, an error 
message will be issued. Table-1 is also applicable to types of literals that may 
be moved to data-name-2. 



EXAMPLE 
NO. 


FROM: data-name- 1 


TO: data-name-2 




Picture 


Value 


Picture 


Value 




1(a) 


9V99 


1V23 


99V9 


01V2 




(b) 


999V99 


123V45 


99999V99 


00123V45 




2(a) 


9V99 


1V23 


999 


001 




(b) 


999V99 


123V45 


999 


123 




3(a) 


9V99 


1V23 


9.99 


1.23 




(b) 


999V99 


123V45 


Z,ZZZ,99 


123.45 




(c) 


999V99 


00000 


Z,ZZZ.99 


.00 




(d) 


999V99 


123V45 


Z,ZZZ 


123 




4(a) 


999 


123 


9999V9 


0123V0 




5(a) 


999 


123 


9(4) 


0123 




(b) 


9(4) 


1234 


999 


234 




6 


999 


123 


ZZZ.99 


123.00 




7 


999 


123 


X(4) 


123A 




8 


999 


123 


XXBX 


12i3 




9 


■9.99 


1.23 


X(4) 


1.23 




10 


9.99 


1.23 


XiBX 


1.A2 




11 


XXX 


123 


9V99 


3V00 




12 


XXX 


123 


9(4) 


0123 




13 


XXX 


012 


zzz 


12 




14 


XXX 


123 


X(4) 


123i 




15 


XXX 


123 


XJCBX 


12i3 




16 


XXX 


ABC 


A (4) 


ABCA 




17 


XXBX 


AB^C 


X(5) 


ABiCA 




18 


XXBX 


ABAC 


XXBX 


ARU 




19 


XXBX 


ABAC 


A(6) 


AB^CAA 




20 


AAA 


ABC 


X(4) 


ABCA 




21 


AAA 


ABC 


X}(:bx 


ABAC 




22(a) 


A(5) 


ABODE 


AAA 


ABC 




(b) 


A(5) 


ABCDE 


A(7) 


ABCDEAA 





When a group is being moved, it is treated as an alphanumeric to 
alphanumeric MOVE (see Note 1), 
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LOAD 



Function: 



Format: 



To transfer the contents of the specified data area to the 
standard accumulator (words 0-3). 



Operation Operation Parameters 

LOAD data- name -1 

Notes : 

1. Data-name- 1 may not contain more than 16 characters. 

2. The size of the accumulator is determined by data-name-1. 
Transferred data is right justified in the accumulator, and 
unused portions of the accumulator are set to zero. 

3. Data-nanie-1 is not affected. 
Examples : 



Source 


Field 


Accumulator 
After Execution 
Of Load 


Picture 


Value 


A(7) 


ABCDEFG 


IpABClDEFGl 


XX 


AB 


lOOABl 


99V999 


12345 


lOOOl 123451 


9999V9 


12345 


1000 1123451 


A(4) 


1234 


|1234| 


A 


A 


|000A| 


X(6) 


-12.34 


|00-1|2.34| 


X(8) 


ABCD-123 


|ABCD 1-1231 
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UNLOAD 



Function: 



Format : 



Notes : 



2. 



3. 



To transfer the contents of the standard accumula(:or 
(words 0-3) to a data area. 



Operation Operation Parameters 

UNLOAD data-name-1 



1. Transferred data is right-justified in the receiving area. 



Data is transferred beginning at the low order end of the 
accumulator. The size of the receiving area determines 
the number of characters which are transferred. The re- 
maining working accumulator characters must be zero. 

If the receiving area is greater in length than 16 characters, 
all characters beyond the 16th character of the receiving area 
are set to zero. 

If the receiving area contains editing characters, the daU from 
the accumulator will be edited according to the edit image of 
the receiving area. The accumulator is assumed to contain the 
same number of characters and decimal places as appear in 
the receiving area. 

The contents and size of the accumulator may be changed by 
this operation. 
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PROCEDURE CONTROL OPERATIONS 



Example: 



Accumulator 
Before Unload 


Receiving Field 




Value 


See Note 5 


Picture 


After Unload 


lOOOl 123451 


J* ♦*♦_ 4<* 


$**123.45 


lOOOOl 00001 


^♦^ ♦♦♦_ +* 




10000 loooil 


^♦^ ♦**_ «« 


$*****. 01 


lOOOO 1 00011 


$$. $$$. $$ 


$.01 


10012 134561 


$$, $$$. $$ 


$1,234.56 


0123 


999 


123 


0012 


999 


012 


OOAB CDEF 


X(6) 


ABCDEF 



C(3MPARE 



Function: 



For mat . 



To compare the contents of two daita areas ;ind to transfer 
control to one of three specified reference symbols based 
upon the result of that comparison. The possible results 
of the compare are: 

if data-name-1 is greater than data-name-2 transfer control 
to refsym-~l 

if data-name-l is equal to data-name-2 transfer control to 
refsym~2 

if data-name-1 is less than data-name-2 triinsfer control to 
refsym~3 



Operation Operation Parameters 

COMPARE |-data-name-l-| |-data-naine-2-N ;refsyni-l;refsym-2;refsyin-3 
l.literal-1 J \.literal-2 J > = < 



Notts: 



2. 



The collating sequence of the Computer Department Standard 
Character Set is the basis for all comparisons. 

Comparison of numeric items. A numeric item may be com- 
piired only to another numeric item. The comparison of numeric 
items is based upon their algebraic values. The item length, in 
terms of the number of digits, is not itself significant. Zero is 
a unique value regardless of the length or sign of an item. A 
numeric item used in a Compare instruction must not exceed 
16 characters. 
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3. Comparison of non-numeric items. 

The following descriptions are written as one would logically 
think of comparing the two fields, not as it is being implemented 
by the object program. 

• Items of equal length. The relationship between two non- 
numeric items is determined by comparing their corres- 
ponding characters, beginning with the high order character 
of each item. 

• Items of unequal length. The relationship is determined as 
described above. If the shorter item is exhausted, it is 
considered to be less than the other item, unless the remain- 
ing characters in the other item are spaces; in which case, 
the two items are considered equal. 

4. The reference symbol for a particular result may be omitted 
by placing its delimiting semicolon immediately after the pre- 
vious delimiting semicolon. If the reference symbol for a par^ 
tfcular condition has bepn omitted and that condition is met, the 
program proceeds to the next line of coding. 



Example: 

Operation 

COMPARE 

COMPARE 

COMPARE 

COMPARE 

COMPARE 



Operation Parameters 

FLD1;FLD2;RS1;RS2;RS3 

FLD1;FLD2;RS1;;RS3 

FLD1;FLD2;;;RS3 

FLD1;FLD2;;RS2 

FLD1;FLD2;RS1 



The setting of the comparison indicators following the execution 
of this macro-instruction is unpredicable. 



IF 



Function: 



Format: 



Option 2. 



Option 3. 



Notes: 



To branch to a specified reference symbol or to continue 
in-line coding based upon the existence of a specified 
condition. 



Option 1. Operation 



Operation Parameters 



j data-name- 11 

IF ; w 

literal-! I 



IF 



IF 



GR 



LS 

m 

NGR 



NLS 



NEQ 



J data-name-2l ( ; 1 
A < )< ■> refsym 

\ literal -2 j |aGOTOZij 



PLUS 

data-name- 1 fi. I MINUS 
ZERO 



sw-name-] A 



lAGOTOi/ 



refsym 




Sn.\ \ AGOTO& f 



refsym 



1. Option 1 

IF, Option 1, follows the rules specified for COMPARE 
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2. Option 2. 

I]^ Option 2, operates only upon numeric items. 

3. Option 3. 

IE Option 3, operates only upon items which have been described 
as switches. (See Use, page2-35. ) A switch is off when it con- 
tains zero and on when it contains any other value. 

4. The word entries in the Operation Parameters must be separated 
from one another by a single space. 

Examples 

Operation Operation Parameters 

IF PA Y-NOAEQaTCPAv~NO^GOTO,' PROCESS 

IF PAY-NOAEQaTCPAY~NO;PROCESS 

IF 99999aEQAPAY~NO;END 

IF GROSSAMINUSAGOTOAERROR 

IF SWIAONAGOTOARDTC 

IF SWlAOFF;READM 



5. 



The setting of the comparison indicattrs following the execution 
of this macro-instruction is unpredictable. 



SETSW 



Function: To set a programmer-specified switch to an on or oil con- 
dition. 



Format: 



Operation 



SETSW 



Operation Parameters 



sw-name-lA 




; sw-name-2A 




;sw-name-10/y \ 
|OFF[ 



Nott s: 
1. 

2 

3 



Any number of switches from one through ten may be set on or 
off in any combination. 

SETSW operates only upon items which have been described as 
switches. (See Use, page 2-35.) 

"SETSW ON" sets the specified switch to a value of one; 
"SETSW OFF" sets the specified switch to a value of zero. 

The switch name must be separated from the specified condition 
by a single space. 



GOTO 



Func t on: To transfer control to a specified reference symbol. 
Foriii:it: 

Op eration Operation Parameters 

(jOTO 

Notes 



refsym 



1. The GOTO results in an unconditional branch to the reference 
symbol specified in the Operation Parameters. 

2. The reference symbol can be modified by only one index word. 
This index must be a fixed index word. 
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Format: 



GOTO. . . DEPENDING ON 



Function: To transfer control to one of n specified reference symbols 
based upon the value of a specified data name. 

Format : 

Operation Operation Parameters 

GOTO refsym-l; . . . ;ref sym-lOO^ iDEPENDINGAON ^ata-name-l 

Notes: 

1. From one to 100 reference symbols may be specified as parameters. 

2. Data-name-1 must be described as a numeric integer. 

3. If the value of data-name-1 is less than one or greater than the 
number of specified reference symbols, the next "in-line" op- 
eration is executed. 

4. Otherwise, control is transferred to the reference symbol whose 
position within the macro-instruction corresponds to the value 

of data-name-1. If data-name-1 equals one, a branch to refsym-l 
is executed; if 15, a branch to refsym-15 is executed; etc. 

5. Each reference symbol can be modified by only one index word. 
This index must be a fixed index word. 



HALT 



Function: To halt the object program, after insuring that all critical 
computer operations have terminated. 



Operation 
HALT 



Operation Parameters 



XXXX 



Notes: 



HALT transfers control to the Basic Input/ Output System Halt 
Routine, which releases control to the operator, after typing 
the message: HLTaXXXX. The operator may continue 
processing by depressing the Run switch. Control will be 
transferred to the instruction immediately following the HALT. 
(See the Basic Input/ Output System write-up, Halt Routine. ) 



END OF PROGRAM 



EOJ 



Function: To terminate processing by the object program. 



Format : 



Operation 
EOJ 



Operation Parameters 



Notes: 



1. 



EOJ transfers control to the Standard Job- Termination Routi:ie, 
which- - 

• insures that all I/O operations have terminated 

• types a standard end-of-Job message 

• searches the system tape for the Program Monitor 

• loads and transfers control to the Program Monitor. 
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ABORT 



Function : To terminate processing by the object program under error 
conditions. 

Format: 



Operation 



Operation Parameters 



Notes: 



ABORT 



1. . ABORT types a standard message, takes a memory dump, and 

transfers control to the Program Monitor. 

2. ABORT is provided as a standard, error-condition exit from the 
object program. 
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ARITHMETIC OPERATIONS 



ADD AND ROUND 



ADDR 



Function: 



Format: 



To add two numeric items and place the rounded result 
in the second item, or a third item, if specified. 



Option 1. 

Ciption 2. 
Notes: 



Operation 



ADDR 



ADDR 



Operation Parameters 



-> 



jdata-name-ii , . « Tj i. ^ 

t literal i' data-name-2 (j data- name- 3) 



data-name-l;literal;data-name-3 



1 . Any data name used as a parameter must be dtjf ined as a 
numeric elementary item in the Data Division. 

2. Any data name used as parameter one or parameter two must 
not contain editir^ characters and must not exceed 16 charac- 
ters in length. 

3. Any literal used as a parameter must be numeric and must 
not exceed 16 digits. 

4. The result of an addition may be sent to a third numeric item 
specified as data-name-3. If the description of data-name-3 
contains editing characters, editing takes place as described 
in the MOVE (see page 2-77.) 

5. If a data~name-3 is not specified, the result is placed in 
data-name-2 (Option 1). 

6. Required data conversion and decimal point alignment are 
automatically provided and the result is rounded to the 
description of the receiving item. 

7. If the magnitude of the result exceeds that of the receiving 
item, the excess high order characters are truncated. 
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8. It the sec-ond parameter is a literal (Option 2), then data-name-3 
must be .specified to receive the sum. 



ADD AND TRUNCATE 



ADDT 



Function: 



Foivmat: 

Option 1. 

Oi>tK)n 2. 

Notes; 



To add two numeric items and place the result in the 
second item or a third item, if specified. 



Ope ration 
ADDT 

ADDT 



Operation P arame ters 
(data- name- 1 



«,., , /;data-name-2 [;data-name-3 

\literal J ' ' 

data-name- 1; literal; data-name- 3 



The notes under ADDR also apply to ADDT, except that under 
note 6, the result is truncated to the description of the 
receiving area. 



STJBTItACT AND ROUND 



SUBR 



F\incti(jii: 

Format; 

Ojjtion 1. 
0),)ii')i, 2. 



To subtract one numeric item from a second numeric 

item and place the rounded result in the second item and/or 

third iteni, if specified. 



Oil e rat ion 
SUBR 

SUBR 



0£eratioiii Parameters 

fdata-name-l V . . or ^ i o i 

<,.. , ^ •,data-name-2L;data-name-3 1 

1 literal \ ' ^ 

data-name-l;literal;data-iiame-3 
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Notes: 
1. 
2. 



Parameter one is subtracted from parameter two. 

Any data name used as a parameter must be defined as a 
numeric elementary item in the Data Division. 

Any data name used as parameter one or parameter two must 
not contain editing characters and must not exceed 16 charac- 
ters in length. 

Any literal used as a parameter must be numeric and must 
not exceed 16 digits. 

The result of a subtraction may be sent to a third numeric item 
specified as data-name-3. If the description of data-name-3 
contains editing characters, editing takes place as described 
in the MOVE (see page 2-77). 

If data-name-3 is not specified, the result is placed in data- 
name-2 (Option 1). 

Required data conversion and decimal point alignment are 
automatically provided and the result is rounded to the 
description of the receiving area. 

If the magnitude of the result exceeds that of the receiving 
area, the excess high order characters are truncated. 

U the second parameter is a literal (Option 2), then data~name-3 
must be specified to receive the difference. 



SUBTRACT AND TRUNCATE 



SUBT 



Function: To subtract one numeric item from a second numeric 

item and place the result in the second item or a third 
item, if specified. 
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Format: 

Option 1. 

Option 2. 
Notes: 



Operation 



SUBT 



SUBT 



Operation Parameter s 
data-name- 1 



■'>■ 



literal f,data-name-2[;data-name-3 ] 

data- name- 1 ; liter al ; data- name- 3 



The notes under SUBR also apply to SUBT, except that under 
note 7, the result is truncated to the description of the 
receiving area. 



MULTIPLY AND ROUND 



MPYR 



Function: 



Format: 





Operation 


Option 1. 


MPYR 


Ojition 2. 


MPYR 


Notes: 





To multiply two numeric items and place the rounded 
product in the second item or a third item, if specified. 



Operation Parameters 
[data- name- r 



1 literal 7;data-name-2 [;data-name-3] 

data-name-l;literal;data-name-3 



1. Any data name used as a parameter must be defined as a 
numeric elementary item in the Data Division. 

2. Any data name used as parameter one or parameter two must 
not contain editing characters and may not exceed eight 
characters in length. 

3. Any literal used as parameter must be numeric and must 
not exceed eight digits. 
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4. The product may be sent to a third numeric item specified as 
data-name-3. If the description of. the third item contains 
editing characters, editing takes place as described in the 
MOVE (seepage 2-77). 

5. If data-name-3 is not specified, the product is placed in 
data-name-2 (Option 1). 

6. Required data conversion and decimal point alignment are 
automatically provided and the product is rounded to the 
description of the receiving area. 

7. If the magnitude of the product exceeds that of the receivii^ 
area, the excess high order characters are truncated. 

8. If the second parameter is a literal (Option 2), then 
data-name-3 must be specified to receive the product. 



MULTIPLY AND TRUNCATE 



MPYT 



Function: 



Format: 



To multiply two numeric items and place the product 
in the second item or a third item, iJ specified. 



Option 1. 

OlJtion 2. 

Nutes: 



Ojjeratkm 
MPYT 

MPYT 



Operation Parameters 
[data- name- 1 



\ literal ndata-name-2 [; data-name-3 ] 

data- name- 1 ; literal:data- name- 3 



The notes under MPYR also apply to MPYT except that under 
note 6, the product is truncated to the description of the 
receiving area. 
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DIVIDE AND ROUND 



DIVR 



Function : 
Format : 

Option 1. 

Option 2. 
Notes : 
1. 



To divide one numeric item by another and place the 
rounded quotient in the second item or a third item, if 
specified. 



Operation 
DIVR 

DIVR 



O peration Parameters 

; data- name- 2 [; data- name- 3 ] 
data-name-l;literal;data-name-3 



Tdata-name-l 
\ literal 



Parameter one is the divisor. Its data description may not 
contain editing characters and must not exceed eight characters 
in length. 

2. Parameter two is the dividend. Its data description may not 
contain editing characters and must not exceed sixteen 
characters in length. 

3. Any data name used as a parameter must be defined as a numeric 
elementary item in the Data Division. 

4. Any literal used as a parameter must be numeric. 

5. The quotient may be only eight characters long. Because of 
this, the divisor must be greater than any portion of the divi- 
dend which occupies the two high-order words of the quadruple 
accumulator, when the dividend has been right justified. 

Example: 



The following division is not allowed: 
Dividend 
Divisor 







12 



3 4 5 6 



7 8 9 9 







5 



This division would result in a nine- character quotient. 



2-96 



12/6/63 



The following division is allowed: 
Dividend 



00 



12 



3 4 5 6 



7 8 9 9 



Divisor 



00000050 



This division would result in an eight character quotient. 

6. The quotient may be sent to a third item specified as 
data-name-3. If the description of data-name-3 contains 
editing characters, editing takes place as described in the 
MOVE (seepage 2-77). 

7. If data-name-3 is not specified, the quotient is placed in 
data-name- 2. 

8. If the second parameter is a literal (Option 2), then 
data-name-3 must be specified to receive the quotient. 

9. Required data conversion and decimal point alignment :ire 
automatically provided and the quotient is rounded to the 
description of the receiving area. 

10. If the number of characters in the quotient is smaller than 
the number of characters in the receiving field, the quotient 
will be placed in the receiving field according to the decimal 
point alignment. Zeros will be filled in any vacant positions 
of the receiviiTg field. (See Picture, Page 2-24). Lf the 

number of characters in the quotient exceeds that of the 
receiving area, the excess high order characters are 
truncated. 



DIVIDE AND TRUNCATE 



DIVT 



Function: To divide one numeric item by another and place the 

truncated result in the second item or a third item, if 
specified. 
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Format: 

Option 1. 

Option 2. 

Notes: 



Op erati on 
DIVT 

DIVT 



Op er ati on Para meter s 
, data-name- 1' 



I literal /•;data-name-2 [;data-name-3 ] 

data- name- 1 ; literal; data- name- 3 



The notes under DIVR also apply to DIVT except that under 
note 9, the quotient is truncated to the description of the 
receiving area. 
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VUl. SEGMENTED PROGRAJ/IS 



In the Macro Assembly Program, provisions are made to produce re- 
locatable segments for use within the GE-425/435 Operating System 
environment. Each segment assembled must be identified by a name 
punched on the output header card. The SEGMENT entry in the 
Identification Division enables the programmer to supply this name and 
to specify a i-elocatable or absolute assembly. (See Chapter IV, Identi- 
fication.) 

Within a segmented environment, a method to indicate communication 
bictween segments must also be provided. This is accomplished by 
including basic assembly language pseudo-operations to indicate the 
reference symbols that will be used for references betv^een segments, 
and to indicate the data descriptions that are comraion to the segments, 
lifference should be made to Chapter IV, Relocatable S(;gments and Chapter 
VI, Pseudo -Operations in the Basic Assembly Language section of 
this manual. A brief description of the pseudo-operations used for 
segmented programs is included in this chapter. 



INTERNAL AND EXTERNAL GLOBAL SYMBOLS 

To indicate the symbols used to transfer from one segment to another, 
llie Macro Assembly Program utilizes two pseudo- operations which 
lire included in the Procedure Division: DIG and DXG. 



DEFINE INTERNAL GLOBAL 



DIG 



DIG i;s used to indicate the global reference symbols which are defined 
ir. tills segment. The n.ames of these references are required at load 
ti.'ue to eiiable separately assembled segments to be liiiked. 



0[)ei'_at^on Opei;_aWon_P:iranieters 

DIG refsym-l,refsym-2,. . . 
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The Operation Parameters columns contain a list of internal global 
references that are defined in the Reference Symbol columns of instruc- 
tions or pseudo-operations written in this segment. The symbols, 
separated by commas, must follow the conventions established for 
reference symbols (see page 2-59). 



Example : 

Ref. Sym. 



Operation Operation Parameters 



DIG 
DIG 



PRTCHECK 
BONDED, TIME 



BONDED 



MOVE DECODE;TEMP4 



PRTCHECK IF PAY'~N0AEQATCPAY~N0AG0T0AEXIT 



TIME 



READ PAYMSTR 



DEFINE EXTERNAL GLOBAL 



DXG 



DXG is used to indicate the global reference symbols which are defined 
in other segments. The names of these references are required at 
load time to enable separately assembled segments to be linked. 

Format; 



Operation Operation Parameters 
DXG refsym-l,refsym-2. . . . 
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The Opt ition Parameters columns contain a list of external global 
reference symbols that are referred to as Operation Parameters in 
the Procedure Division of this segment. The reference symbols, 
separated by commas, must follow the conventions established for 
reference symbols (see page 2-59. ) 



Example: 



Operation Operation Parameters 



DXG BONDED, TIME 

DXG PRTCHECK 



PXB 



BONDED, 6 



PXB 



TIME, 6 



PXB 



PRTCHECK. 6 



COMMON DATA AREAS 

If a file, record, or work area is referred to by macro- instructions in 
several separately assembled segments, their descriptions must appear 
in each segment. Repetition of this description is necessary in order 
to provide the macro-generators with the characteristics of the data 
during the assembly of each segment. These characteristics (i. e. , 
mode, size, relative position within the word) determine the patterns 
of instructions to be generated. Since it is only necessary to allocate 
storage for the areas within one segment, the AREADEF file parametei- 
(see page 2-47 ) and the DGRR,DGRE, and DOR pseudo-operations 
(see Basic Assembly Lar^uage section, Chapter VI, Pseudo-Operations) 
are included in the macro assembly source language. 
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AREADEF 



The AREADEF file parameter is used to indicate whether the buffer 
area(s), DCW list(s), and File Table are to be generated by the Macro 
Assembly Program, supplied by the programmer in this segment, or 
have been supplied in a separate segment. This file parameter is 
written m the file parameter list associated with each file described 
in the File Section. 



The parameter has the following format: 



fc 



GENERATE f-refsymboil 1 
AREADEF ( DEFINED ^- \ 

1^ REMOTE / 

For a discussion of the options see page 2-47. 



DEFINE GLOBAL REFERENCE REMOTE 



DGRR 



The DGRR pseudo-operation is used to indicate a chain of common 
data that has storage allocated in some other segment (see DGR). 
The DGRR may not be used in the File Section. 

Format: 



Ref. Sym. 


Operation 


Operation Parameters 


refsym-l 


DGRR 




Example: 






Data- name 


Level 


Svnc Use Picture 


PAYREC 
PAYDTL 
PAY- NO 
ORG 
DATE 


DGRR 

01 

02 

02 

02 


9(5) 
9(4) 
9(6) 



DGRE 
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In the example, because of the DGRR, the assembly program will classiiy 
Its reference symbol as external. The characteristics of the items 
will be saved for use by the macro-generators. All the data names 
lollowing PAYREC will be treated as relative to PAYREC until: 

• the assembler encounters another DGRR which reinitiates the 
entire process with a new external global; or, 

m the assembler encounters a DGRE (Define Global Reference Ends) 
which terminates the reference area; or, 

* the Procedure Division line is encountered. 



DEFINE GLOBAL REFERENCE ENDS 



DGRE 



When the global reference is defined remotely,. an indication must be 
given when the definition is completed. This will resume normal 
assembly and allocate storage. DGRE performs this function. It may 
not be used m the File Section. ^ 

Format: 

Refi_S!iE- Operation Operation Paramete rs 

DGRE 



DEFINE GLOBAL REFERENCE 



DGR 



One segment of the program must allocate storage to the common data 
areas that are referred to in other segments. The JDGR pseudo- 
operation IS used to indicate the beginning of common st.jrage in this 
segment. This pseudo-operation may not be used in the File Section. 

Format: 

Ref. Sym. Operation Operation Parameter s 

refsym-l DGR 
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IX. SAMPLE PROBLEM 



Example: 



Level Sync Use Picture 



DGR 




01 




02 


9(5) 


02 


9(4) 


02 


9(6) 



Data-Name 

PAYREC 

PAYDTL 

PAY~NO 

ORG 

DATE 

Because of the DGR, the assembly program indicates PAYREC is an 
internal global reference. Characteristics of the items are saved for 
use by the macro-generators, and storage is allocated for the logical 
record described following the DGR pseudo-operation. The first entry 
following the DGR in the Working Storage Section must be assigned 
level 01. 



PAYROLL APPLICATION 



FLOW CHART 




StT UP 




StT 
6M 







Stn up 

6«l(0»Mt»SMC 

* 2. i. rifl. 



EuD-OP JOB 

Close P»-a. files 







wo 


SET UP OUTPUT 

Recos.t>s 

et«ss 

Tft>. 
NET 












WR»T6 
CtP(VV*^STR 
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PAYROLL SAMPLE PROBLEM 



FILE STRUCTURE 



N3 



o 



Input 



t<? ???|??9y|9?yy1y9?»|?9 99l99 »9 1??yy1?y?? ??99l7? ??h')*»«Jh9?7|9'j?G; 



0099 



MUHMK. 



OK* M« B^ WIS pfs<y 



(IhTt 



PWYMASTER CoKiTihAJATioN 






OftTt 6(UlSS 



[999TI 



&1IMS 






t>eoo£<i) 



t>M^o«»JTCO 



eo99 



9999l0Q99]9999|0C99l9999|0099l99 '^ 9 ] 0699 J999? |>\f\ft/V lA RK/\|AftAv>\ |fiftftfi|ftPvG& 
^- ■ » >— )< ^Zj '^ » ' CTTjiTr r — r n 1 i « .> "^ ' ' 1 



Time Carp 



<■•»«,"- 

i»:l 



txootW CT:oT)e(i) DtootCs) otopttrt 

©ftt«»ouunjD DWowuTfi; W«^o,n-(.4) o^M•Wi^^ dwo^mtU) *"'' 



V 

lAKT N/SK\E. 



9999 9999 9999 99fi-6 



_n_^>. 



^ '—v 

Pfc-V MO Oft VR HOUM 

NUMMIt ' , ' wmtJ. 

DAXe. 



Output 

PAYMASTER 



S^Ht Format as Input paymaster 



to 

05 



05 
CO 



BvY CHECKS 

[i^AAAJA9'T9]99""^ 



-r '' 1- 



AAA^i 



A'AA|' AAAIaAAA ]^A AA 



A^^A 



AAA^^99-|99-9|9AA^;ij.gkA>t^t[^. Qp 



_»v 



PftV 



4NIT IMIT 



t- L. L. 

f^O pft VR. 



MET PKi 






GENERAL«ELECTRIC 



GE -425/435 PROGRAMMING FORM 



. ft , Q , 0, 1 1 

t)i Q. 0, Cli-^rfl 

_lL_Di_^J5i-l-ft. 
n , a , Q, Q.S ft 



PQVKOLL h<^r(\PLt PR,o6LfrO 






0. O. IS .s 

_0j_OjJij.ai 1. 1-0 
0x0^0^2.^.. a. 

a a, Q.3 lO lO 

n .ft .fii^ li 
ft . Q n,"^ ,^ _ 
I ^, 0.3 ,H ,0_ 

Q I n, ai3 5 .0 ., 

aft- 
f>.O.O.T,<^ ,fl 






iLtl.'dJl^.A 



T I.-.T 






^ d1£U-^S- C -H-X . XI i_JJ_JlJ:.A J" ^i,T .1 , V ,L. 



r. ;£^jI: ^iS f .giRii . 



ft, o, o. A,n ,0 „ 
_£i4 0^0.4-1.0 






e> wjiij 



m 



L £__ 






PiCDju iC--lT 

iD-ufl.m U N T 

.L.La..T I.N I T 
iJyJlJ NIT 



.0.2I- 



03 
2 
1 



- - 



p.A.y.i 



CHft^LIE BftOnJM 



I 1 - t - t i 



1::%^^ 



i^ft.^^/ . 



P.fl .y .-viA .f\ ,1 



P.fl , y .R iO.L.L,' ,^,fl.rfL-EL.LX-i Jlifi_..sLja-,.L-X 



iK- 



R L /\ Y 







„i^ii<i,' ? i a .jV-.9 , a 



, 1 i T . l ^y^^^- 



li S . ? . v . 'i ,'^ 



-lix- 



la - 



4: _-::::: 



v 



Sample Problem Written in- 
Macro Assembly Language 



GENERAL® ELECTRIC 



GE-425/435 PR0GKAMM:NG FORM 



SPifTyPLi. PftVCiOLi. PROftL,t.fVN 


PROGR.UUCR 


SEQUENCE 


^ 




REFERENCE SYMBOL 


1 


OP.R. 


OAT..,.Mf 


„ 


LEVEt 


„ 


s 


„ 


". 




P.CTU,. 


.. 




O,0,o,4,5i ,c 






L ,A ,5 ,T ,l\/.fl,IA,r 




DiX 












fi,C , 1 , (>, ) , , 1 , , 1 J 






0,0,0, ■^,5, 5 




















x,x 






0,0, n.4,"7 ,0 






T,I ,N\,f ,C,D,5, 
























n f-.U 


1 


r 


e. 






rl, 1 , n , 1 






0,O,0,4,R,6 






C'os.mlJYi 


/\ 


NT)' 


f^.cr) 






n,o,o,ia,<i.o 







p 


f T Ia 


p 


n 


R 




E.N.n,2. 






0, 0, n, ';,r>,rv 


' 







0,1 
















0, 0, 0,5 ,1 ,0 

0,0, fi.s .1 .ft 

0, 0,0,5 L^ ,0 


-'-, - 


-r,c,p f) Y,-,i^',A 




ft,i 








u 




1 ,(,»;, 1 






T..,tLJX,« ,T i£.^ _i_ 


- 


Xlxll 






1) 




S, (,t,.) : , 






H,R,S ,iu,KlD, , . 


0.2 1 


.... 




II 




'i,'i,v,f 






0,0, o,& A ,0 




(K,P,0,V ,N\.<i ,T ,R 


11 


F,n 














0,0, 0,5 £ ,6 






t.V^I 


C.lf 






0,4,04 






0,0, o,S ,fe .* 
a, 0, o,£ ,T ,0 


— h — 


......._.^.^^_^_^^__ 


c t mmWN -D , 


'A',T,8 






T 


i:,L.i: 


i-^b.!4 Id 

T..^Y.;P_.l£. 


r.i X , c M , A,N/ ,r-, ,f 






0, 0, c"; ,q ,() 






Eh 


«,U,T .f ,IJ ,T 










a_k.-<_i. 
pjfL -r_s_ 

L;A,a,£._ 

^.0x1 _ 




£.1 


J 






0,0, 0,(, ,0 ,fi 
0,0, 0,(3 . 1 ,l> 


- 


T ly 


), 






L i)(£liP 


S ,T ,fl M .p ,Pi .«, .fl . . , , 






0, Q, O.k.^.O 

0, 0. 0, t.,:io 


- 




r 


1,1,0,1 






-W 


$,L,C,DiO, 0,0,1 ,P,ft ,V ,(A 
X .f ,1 ,2 ,0, ) , 


S .T ,R 1 




0, 0, 0. (> ^ ,c^ 
, C.,t.5 .0 






T" 




,__. 


. .;FiD . 












0,0,0,fc.fc ,0 
0, 0, 0, t,l ,0 


L:i.':. 




0,/!,0, 1 






X i , X . X . c fflM fa'a w n 


!',R,f 






0, 0, 0, b,ft.o 




LLJ!L_F-.ii 
.0_lJ_ 

. . O.I., _ 

_7;oliV'V. 

,Oii_, . 
_,£xJ 

- ic,2 ;._. 

. ^o.,.il_ 




JilEj 


P,R ,i^.,i^ ,R ,p,l? 






tl,0,Q,t ,1,0 


_| 




.i- 




X,{ . t,,4 ,) 






0, 0,0,7,0,0 




w 


?i 


£ ,C,T, 1 ,jJ(,N/ 






0, D, 0, 7, 1 ,0 


— 












0,0, 7, 2., 








X. (.■?;, 1 ,) 






Si^S 0, n.i ,ft 
0, 0,0, 7,4 ,0 


c 


* . _ ._...::"::.: 


















t.R^nixixej_xfl_. 
m!s,G,3, "^'^^ '■ 


) 


-- 


T.( ,S.) , 






0, Ci ti, 7,5,0 




x,y , 


.X_^_.X..- 




0,0,0, 7, fo,0 














0,0,0,7,7 ,0 




— 


X.( ,1,2. 
1 A ,•=>,■) 


) 




Q, ^, 0^1,^.0:. 

Oi p,o^i_OuCL 

0,0,0,%,! ,0 





]_ ' 








,_. ilx2.^ 




— 


~ 


X.,ij_^ ..^ X. XX ,_^^x 








0,1 


P( x4_,_LjJ_i 

9x5-x3L,.Vx 


1 ,,.,,. . 






T,f.,^A.?,4, , , 




6,1 


R 






'1 ,<i , , , , , 






01,0,0,8,1,0 




t,H,£,C,K, , , 




fi,-!. 




-- 




— 








0, 0, c,|R ,.^ ,0 
0, 0, 0,R ,A ,0 
0, 0, 0,R ,5 ,0 








f), i 




fl ,« ,^,) . , , , , , , , 






c.p.a y.~_iv,-Oj__ 
x..A_.^xXj; i,i I. J 


— 


-OJ^I... 
.tlji_. 




■ ^^ 




9 1 C , .=, , ) 








a.i-Cxia.x 

. ..... J L 








fi.Lp,o^4t.,0 


!..; _ 








jCi 0,0,8 ,7,0' ,' : 


Z ' 'fl ft 


, 


^ 




,.Q o,o.&„Ai 0; .Ci.N,j3JNIT 0.1, fl 


, . 









0. ,;» 




'2 - t, - t3 


P.= . , 1 

2. 4 


■.METERS 




cu„,^^ 


*' To 







J . , x_ J. 


PJL,V', 


_^ 


^ ^ J. J J 


, 




^ 








.X 

"^ — 
J — 




, , , , 


-- 


x_._ 








, , , , 








IM. 


, . 1 





1 J X X X 






-- 


, 1 1 , 


1 




, 


, ^ 




1 1 > 1 


, , 1 


1 , _, , 








-^^ .^^...X,x_x X..., X. .,_ X. 1- , _ 


1 





1 




..!_ 1 1 _l _l 

. . L. 1 1 ._, ... 
- — 1 i. ... i- -1... - 


,. ..... . ., X 1 .,_.. X. . 


— f. ..J— X __.__! ._X- 


-x._L X-. . , : . 




.L..LSlLh.^^.^£i^S^.LC .< ,0_^^__\^4>. ,_. X 1 







J X ,_ 


1 


^ _^ ^ _^ 




_-.._X ..X.._X . X X .... X , , , , . 


^ 






-.^_. . ^_x_.,...X- ^..X..,_.x_.x .. _, ,_x_.x.,. , 


- jsi!^!;. 




, , , , 


3 , S , T , W . ,!V , .f ■ ff> .0. ■ V £1 ^ 


I 




, . 




" , A, / ,T,I 


pA,L , 1 c, fi 1 R ,n , .N^ -I ,< 








L .1 . 1 . . ; .) . 1 


L X ^ _._, 


1 , , , 


",A, 1 , ■', 


1 




-- 




^ , , ^ ^ ^ ^ _^ ,_.j._, 


■» 


" -A J.iUxBix 


m.fl ,T, c,H ,r ,I>, ,T,i.M,r, ,c,f\,n^n 


4. 1 , a.. 
" ..A,_.l, ' , 




_..X. _l_.x._X_ ^.J 








^-- 


_''_uA, 1 i£ja;j1x ,o.ri ,J,o.e,A, 1, •', , _,,^_x , 


1 , 1 II, 


^ , 1 ^ j_ , ^ 4_ _x X J I L- 




^ 






.., 


. X X 


, 




^ ' 


._x . _x_. 


h'-^- 


x_._. 


■■ .A-AxAxA 


A. -x.^., , , , 














A I /\,^ ,A 


^. A ,",,,, , 








^_.X. 




X ,_ 








"--• 




. L -Jl 


" '> 


i 

5 



Sample Problem Cont. 



GENERAL0ELECTRIC 



GE -425/435 PROGRAMMING FORM 



01 



PRO BR AM 


\/fiftLL sAmDut PRoButm 


PRO OR AMMER 


'l-b-t3 


•ASK W 

3 4 


■EQUCNCE 


T 
E 




REFERENCe »¥M»Ol_ 


OPERA 


TroN 1 


OPERATION PARAMETERS 








V.'-f.^ 








Si 

E 




PICTURE 
2S *^ 


OCCUP« 
41 44 


VALUE 

4. . li 


■,'j 1 


n,Q, 0, "i. 1 ,0 

O.O, 0.1.1 ,o 
O.O.O.'^.'i.O 
O.Cl.O,S,4 ,o 

0.0, o,q,5,o 


- 


- 


C.L,A,S,T,W 
(L.m.91, , . 


Irt, 


- 


0.? 
ft ,2 
0.1 

0.3 




- 




— 


— 


A.CI.i,), . 
ft, Pi. PI. 1 . . 
1,1 

r. 

1.1 

X 


^-^-^ 


— 




—^ 




i-i 




1 




-^ 




^ 


i_ — I 






— 


__1 1 1 1 J 1 « 1 


— ' 


. 1 




P.f 


.Y , 


n.o, o.q.b.o 

Q, 0. 0,<i,P, ,n 
r>.o,o,<),i ,h 


— 




C,V,R, , 1 

C.N.f: T . . 

S,u;, 1 . . . 

X,R,fl, , . 
T,£,ivi,P,l , 




- 


fi,2 

n,i 

0,1 
0,1 




& 




I 

1_ 


L— 


1,1. , , . , 

x.x 

1i1,1 .1 ,V.=I ,1 




— 




_^. 


.ill 1 






Z! 


ill"l 


^ 






„^. 






^ 


1 1 . >J -J 1 ■ 1 1 


. — 1 


1. 1 




^ 


-J L- 

h* — ^ 
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Sample Problem Cont. 



ALPHABETIC TABLE OF MACRO INSTRUCTIONS 

ABORT 2-90 

ADDR — Add and Round 2-91 

ADDT -- Add and Truncate 2-92 

CLOSE 2-73 

COMPARE 2-83 

DIVR — Divide and Round 2-96 

DIVT -- Divide and Truncate 2-97 

EOJ 2-89 

Extended Input/Output System Service Macro Instructions .... 2-74 

GOTO 2-87 

GOTO . . . DEPENDING ON 2-88 

HALT 2-88 

IF 2-85 

LOAD 2-80 

MOVE 2-77 

MPYR -- Multiply and Round 2-94 

MPYT -- Multiply and Truncate 2-95 

OPEN 2-72 

READ 2-68 

SETSW 2-86 

SUBR — Subtract and Round 2-92 
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SUBT — Subtract and Truncate 2-93 

TYPE 2-74 

UNLOAD 2-81 

WRITE 2-68 

WRITEX 2-63 
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ASSEMBLY FUNCTIONS 



SOURCE PROGRAM 

To prepare any Macro Assembly Program source language program for 
an assembly, the source deck must be organized in the following sequence: 



Working 
Storagsi 

File 
Section 





Required 



— Required 



Language Pro- 
cessor Option 
Cards 



<MAP* Language 

Processor 

Control Card 



- Required 
-Required 

Required 



+MAP - used here as an abbreviation for Macro Assembly Program 
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The Environment and Data Divisions are not required if the source 
program contains only basic assembly language instructions. 

Language Processor Control Cards 

A language processor control card causes the Program Monitor to 
search the systems tape, load, and trsmsfer to the beginning of the 
Macro Assembly Program. 

Following this control card in the source deck will tie the language 
processor option cards. These cards, if present, specify deviations 
from the standard assembly procedure. They may be used to specify: 

• the source language deck is to be read from tape 

• the object program decks are to be written on tape, or both cards 
and tape 

• a sequence check on the source language deck is to be performed 

• the coding generated for the macro- instructions should not be 
printed on the assembly listing. 

The standard mode of assembly and the format of the language proces- 
sor (LP) option cards will be specified at a later date. 

A blank card must follow the last LP option card. 



ASSEMBLER PROGRAM ORGANIZATION 

The Macro Assembly Program is a multi-pass macro assembler 
which processes a source program from punched ca;rd or magnetic 
tape input. The nature of the instructions which appear in the source 
program determines the number of passes required to produce an 
object program. H the source program contains macro- instructions, 
it is processed through the Translator, Selector, and Assembler 
phases of the Macro Assembly Program. If the source program does 
not contain macro-instructions, processing proceeds directly to the 
Assembler phase, bypassing phases of the Macro Assembly Program 
that are not essential to the assembly. See Figure 3-1. 
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Translator 

The Translator reads and processes the source program. The following 
functions are executed while (irocessing the Data Division. The Trans- 
lator -- 

• constructs a File Table for each file encountered in the File Section. 

• constructs basic assembly language pseudo-operations to allocate 
memory to aiid/or define constants for the data names encountered 
in record descriptions 

• constructs a Data Description Table which contains complete field 
characteristics of each data name encountered m record descrip- 
tions. 

As the Translator processes the Pr<jcedure Division, a magnetic tape 
is written which contains the basic assembly language symbolic instruc- 
tions, pseudo-operations, and the macro-calls. A macro-call identifies 
a macro-instruction and its parameters. When a iiarameter is a data 
name, the macro-call includes tlie characteristics ut the data name from 
the Data Description Table. 

Selector 

The Selector controls the generation of basic assembly language sym- 
bolic instructions, by linking the macro-calls with their required 
generators. The generated l)asic assembly language instructions are 
written to t ape along with the input instructions. Memory available 
for generators is allocated by a method which takes into account fre- 
quence of use and nesting of generators so that a minimum number of 
passes of macro-calls is required. 

Asse mbler 

The basic assembly language instructions, both input and generated, 
are then assembled. The assembly listing and object program card 
deck are produced simultaneously. 
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Intermixed Macro anc 
Basic Assembly Language 



Basic Assembly Language 
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Basic 
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Language 
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Program 
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Listing 
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/'f object 
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Figure 3-1. The GE-425/435 Macro Assembly Program 
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LOADING PROGRAM 

Input to the loader consists of a relocatable binary deck for each seg- 
ment to be loaded. These relocatable decjss contain global symbols, 
relative addresses, relocation indicators, instructions, and requests 
for other segments. The loader's function is to combine these seg- 
ments to form an operational program. 

Card Types Produced by the Assemb ler 

Seven card types are produced by the assembler and recognized and 
processed by the loader. 

Header card 
Origin card 
Internal global card 
Instruction card 
External global card 
TCD card 
END card 

Any segment must contain a header card and ;ui END or TCD card. 
The following statements can be made for all card types. 

1. All cards are binary and have a 7-9 punch in column 1. 

2. Columns 74-80 are not examined by the loader. 

3. An 8-punch in column 1 causes the checksum to be ignored. 
This is indicated by an X on card forms. 

4. Checksum includes columjis 1 through 73. 

5. Card type is located in the 12-3 row of column 1. 

6. Column 2 is reserved for a folded checksum. 

7. Column 4 contains a segment sequence number which is 
checked by the loader. 



The fo]-mat for the seven types of cards produced by the assembler 
follows: 

Header Card Format 
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Notes 



1. In column 1 if Y = the segment is not forced to origin at 

mod 4 
if Y = 1 the segment is forced to origin at mod 4. 

2. Weird count is the number of calls and includes on the caj:-d. 

3. Column 73 contains the number of calls and includes for the 
segment. 

4. If more than 1 header card is needed for a segment columns 
5-8 and 73 are duplicated on the additional header caurds. 

5. Card type 40 or 41. 
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Origin Card Format 



Internal Global Card Format 
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Notes 



Notes 



1. Columns 5 and 6 contain an absolute address to which the seg- 
ment may be origined. 

2. If a global symbol is in colunms 7- 10, its value will be added to 
the value in columns 5 and 6 to form the origin. 

3. The global must have been previously defined by the loader. 

4. If mod 4 was requested on the header, the origin is forced 
to mod 4. 

5. Card type 3. 



1. Word count contains the number of internally defined globals 
on this card. 

2. IfX = Y = Z= O.the symbol is equated to the absolute value in 
the associated address. 

3. IfX = Y = 0, Z = l.toe symbol is equated to the address formed 
by the addition of the address to the segment origin, i. e. the 
symbol is relocatable. 

4. If X = 0, Y = 1, Z = O.the block associated with the symbol is 
treated as a BSSL. 

5. IfX = 0, Y = Z = 1 the block associated with the symbol is 
treated as an ARPL. 



IfX = l, Y = Z= 0,the block associated with the symbol is 
treated as an LSBL. 
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HX = Y = 1, Z= O.the block associated with the symbol is 
treated as a BPSL. 
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Instruction Card Format 



External Global Format 
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Notes 



Notes 



1. Word count is the number of instructions on the card. Maxi- 
mum of 30 instructions per card. 

2. Y is a 3-bit flag associated with each instruction of the form 

. o2 ,1 „0 

A- ^ +B' ^ +C- '^ where A is presently 0. 

3. Flag bits immediately follow the last instruction on the card. 

4. If B = 1 ,the associated instruction is to be treated as an abso- 
lute increment for the loader P- counter. 

5. If B = 0,the associated instruction is a true instruction. 

6. If B = 0, C = the associated instruction is absolute. 

7. If B = 0, C = 1, relocate the address in the associated instruc- 
tion by the segment origin. 

8. Card type 4. 



1. A symbol must be contained in a card but reference address 
can be continued on the next carcJ. 

2. The relative address is relative to the segment origin. 

3. If X in the relative address is 0, the value of the symbol will 
be added to the contents of the reference address. If X is 1 
the value of the symbol will be subtracted from the contents 
of the reference address. 

4. II Y is 1, an external symbol follows; if Y is another rela- 
tive address follows. 

5. If Z is 1, this is the last item on this card; if 21 is at least 
one more field follows. 

6. More than one symbol may refer to the same relative address. 

7. Card type 5. 
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TCD Card Format 
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Note 



1. Columns 5 and 6 contain an absolute address to which the 
loader may transfer control. 

2. If a global symbol is in columns 7-10, its value will be added 
to the value in columns 5 and 6 to form the transfer address. 

3. The global must have been previously defined by the loader. 

4. If X = 1 in column 5, the numeric address in columns 5-6 will 
be added to the segment origin. 

5. There cannot be a TCD to absolute zero. 

6. Card type 60. 
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End Card Format 
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Notes 



1. Columns 5 and 6 contain an absolute address to which the 
loader may transfer control. 

2. If a global symbol is in columns 7-10, its value will be addied 
to the value in columns 5 and 6 to form the transfer address. 

3. The global must have been previously defined by the loader. 

4. If X = 1 in column 5, the numeric address in columns 5-6 will 
be added to the segment origin to form the transfer address. 

5. Card type 70. 
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Octal Patch Card 

The loader accepts and operates on octal cards which are inserted in a 
segment before the segment TCD or END card. These cards are octal 
corrections to the segment and these corrections may be absolute or 
relocatable. A correction card is checked by the loader to insure that 
it is octal and that an error message is typed it any non-octal characters 
are found through column 20. Any hollerith information can exist after 
column 20. 

The octal patch card has the following format: 



\ ^ 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 



octal location 

where patch 

is placed 



octal patch 



where A = if columns 4-8 are an absolute address 

= 1 if columns 4-8 are relocatable and the segment origin is 
to be added to form the location to be patched 

B = if columns 16-20 are an absolute address 

= 1 if columns 16-20 are relocatable and the segment origin 
is to be added to form the desired address 

All address calculations are modulo-15 bits. 

Column 1 contains a 0. 
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Segment Deck Order 

Each segment deck is sequenced in column 4. The cards within a 
segment must not be shifted from their punched order. The order 
for each format is given below with an asterisk indi.cating that the 
format must be present. 

* 1. Header card 

2. Origin card 

3. Internal global card 

4. Instruction card 

5. External global card 

6. Octal patches 

* 7. TCD or END card 

For a more detailed discussion, see tlie GE-425/435 Loader write-up. 

f+l OUTPUTS OF THE ASSEMBLER 

fr ASSEMBLY SOURCE LANGUAGE ERFtORS AND REMEDIES 
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